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KADIO AND TELEVISION INTERFERENCE 


The equipment described in this manual generates and uses radio frequency energy. 
if it is not installed properly, that is, in strict accordance with our instruc~ 


tions, it may cause interference with radio and television reception. 


This equipment has been type tested and found to comply with the limits for a 
Class B computing device in accordance with the specifications in Subpart J of 
Part 15 of FCC Rules. These rules are designed to provide reasonable protec- 
tion against such interference in a residential installation. However, there is 


no guarantee that interference will not occur in a particular installation. 


You can determine whether your computer is causing interference by turning it 
off. If the interference stops, it was probably caused by the computer or its 


peripheral devices. To further isolate the problem: 


Disconnect the peripheral devices and their input/output cables one 

at a time. (First turn off the computer power, disconnect the I/0 
cable, then turn the computer power back on.) I the interference 
stops, it is caused by either the peripheral device or its 1/0 

cable. These devices usually require shielded I/O cables. For Micro- 
Sci peripheral devices, you can obtain the proper shielded cable from 
your dealer or Micro-Sci. For other peripheral devices, contact the 
manufacturer or your dealer for assistance. 


If your computer does cause interference to radio or television reception, 


you can try to correct the interference by using one or more of the following 


measures: 

* Turn the TV or radio antenna until the interference stops. 

* Move the computer to one side or the other of the TV or radio. 

* Move the computer farther away from the TV or radio. 

* Plug the computer into an outlet that is controlled by a different 
circut breaker or fuse than the TV or radio. 

* Consider installing a rooftop television antenna with coaxial cable 


lead-in between the antenna and TV. 


If necessary, you should consult your dealer or an experienced radio/television 
technician for additional suggestions. You may find the following booklet pre- 
pared by the Federal Communications Commission helpful: 

"How to Identify and Resolve Radio/TV Interference Problems" 
This booklet is available from the 


U.S. Government Printing Office 
Washington, DC 20402 
Stock No. 004-000-00345-4 
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is not how well he Dances; 
but that he can 
Dance At All’ 


Copyright © 1983 
ALF Products Inc. 


1315F Nelson Street 


Denver, CO 80215 
U.S.A. 





Part Number 11-1-1C 





The information in this manual was believed to be accurate at the time of publication. Although this manual has 
been carefully checked for accuracy by our inebriated technical staff, we assume no responsibility for errors or 
omissions. ALF reserves the right to make changes in the product and/or specifications without notice. 


MUSIC CARD MC1 & MUSIC CARD MC16 
FULL 1 YEAR WARRANTY 


ALF Products Inc. warrants that computer programs will function as described in their associated Oowner’s 
manuals, and that all other items will be free of defects in material and workmanship. ALF will correct any fault in a 
computer program (or its manual, or both) or repair or replace (at ALF’s choice) any defective item free of charge for 
one year from the date of sale by ALF. 

To obtain warranty service, you must contact ALF at 1315F Nelson Street, Denver, Colorado 80215 or (303)- 
234-0871 for a service address. You must send the complete product, proof of purchase date, and a detailed 
description of the difficulty to the service address. You pay for shipment to ALF, ALF pays for shipment back. 

Any alteration of the product serial number voids this warranty. This warranty covers only ALF’s products, so 
where local laws permit ALF will not be liable for consequential damages. 

Ask your state government for details on their ‘‘implied warranty’’ which also covers this product. 


The following statements, which shed no new meaning on this warranty, are required by Federal Trade Commission regulations and are meant to simplify warranty language: “Some 
states do not allow the exclusion or limitation of incidental or consequential damages, so the above limitation or exclusion may not apply to you.” and “This warranty gives you 
specific legal rights, and you may also have other rights which vary from state to state.”’ 


CONGRATULATIONS! 


ALF’s ‘‘MC’’ series of music cards is recognized world wide as the standard of excellence for Apple-compatible 
music peripherals. The legendary MC16, originally introduced in 1979 as the ‘‘Apple Music Synthesizer’, was the 
first music card available for the Apple. Many software companies have chosen the MC series as the only Apple 
music card supported by their programs. The unmatched signal quality and fine craftsmanship of the MC16 Is 
demanded by discriminating music educators at prestigious universities. Even the most demanding perfectionists 
have praised the music cards’ versatility, ease of use, and excellent human interface. 

Your choice of an ALF ‘‘MC’”’ series music card reflects your appreciation of advanced technology in a musical 
instrument. With your purchase, you join the elite group of ALF users — thousands of intelligent, sophisticated 
computer owners with a variety of interests. Your music card places a new dimension of music at your fingertips, 
and allows you to explore new regions of your own creativity. 

We've enjoyed creating this music card for you, and we sincerely hope it will continue to give you enjoyment for 
years to come. Thank you for choosing ALF. 


Project engineers: Rick Harman, John Ridges, Philip Tubb. 

Software design: Tim Gill, John Ridges, Forrest Thiessen, Philip Tubb. 
Manual written by: Philip Tubb. 

Index by: Greg Bloom. 

Manual graphics by: Rick Harman, Mary Otis. 

Automatic graphics by: John Ridges, Philip Tubb. 

Photos: Chuck Renstrom. 

Printed by: Generation Printing. 


‘‘Apple’’ is a trademark of Apple Computer Inc. 
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THIS MANUAL DOES NOT COVER USE OF THE APPLE II COMPUTER. READ THE MANUALS 
SUPPLIED WITH YOUR APPLE, AND FAMILIARIZE YOURSELF WITH ITS USE, BEFORE 
CONTINUING. 


PLEASE READ THIS ENTIRE SECTION BEFORE BEGINNING. 


Installation of your Apple II compatible music card is easy. Just follow these 
instructions: 


1. You will need an audio amplifier and speakers or a home hi-fi system. The 
MCl requires a stereo amplifier (a Y adapter or a special cable, order number 
1f-1-2, can be used for connection to a monophonic amplifier). One to three 
MC16 cards can be used with a stereo amplifier, and one or two MC16 cards 
can be used with a monophonic amplifier; see the diagram on the opposite 
page. Turn your amplifier off and the volume all the way down. 


2. Turn the Apple off and remove the top cover. 


3. Route the audio output cable(s) through one of the holes in the back of the 
Apple. Attach the cable(s) to the music card(s). You'll notice that the 
connector(s) on the end of the audio cable can be plugged into the 3-prong 
connector(s) on the music card(s) in either of two ways: with the slots in the 
plastic housing toward the circuit card or away from it. You may plug them 
in either way. Just be sure all three prongs go into the three holes in the 
plastic connector. On the MC1l, reversing the connector will reverse the 
Stereo output (Left becomes Right and vice-versa.) 


4, Plug the music card(s) into expansion slot(s). Any slots may be used, but when 
using more than one MC16 card they must be plugged into adjacent slots. 
Replace the top cover of the Apple. 


5. Plug the audio cable(s) into your amplifier or home hi-fi System. Any of a 
variety of inputs may used, such as Aux (or Auxiliary), Tuner, or Tape Play. 
Do not use Phono (phonograph) inputs. Connect one plug to the Left input and 
the other to the Right input of the same type (e.g. Aux left and Aux right). 
(There will be only one plug to plug in when using a monophonic amplifier.) 
When using the music card, set the amplifier to select the input used (Aux or 
Tuner, or Tape for "tape play" or "tape in"). 


6. The music card is supplied with several programs on disk. (Most programs can 
be loaded from disk and saved on cassette tape for use on Systems without a 
disk.) Each program which uses the music card has a line which contains 
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information regarding the slot number of the card. This line is always 
located at line 1f. The first time you boot the software disk, the Start-up 
program will ask you which slot(s) your music card(s) are in and modify line 
1f in all appropriate programs. IMPORTANT: you must not stop this 
configuration program while it is modifying the programs or some programs 
may be lost. Wait for the menu to reappear. If you ever change which slot(s) 
your music card(s) are in, select the "reconfigure programs" option from the 
menu. 


If for some reason you wish to change line 19 in a program yourself, you 
must load the program, change line 1, and then save it. The exact procedure 
required for each program is explained in that program's section. If you 
change line 18 you must load the program, change line 19, carefully making 
Sure the length of the line is not changed, and then save the program. You 
must not save a program after it has been run, since it has then modified 
itself and thus will not contain many important statements which were 
originally present. Some MC16 programs also have a "units" setting in line 19 
which indicates the number of MC16 cards being used. This is also set by the 
boot-up program. If you wish to change the line yourself, the following SLOT 
and UNITS values should be used: 








UNITS=1  UNITS=2  #UNITS=3 
SLOT=9 MC16's in slots: Q 0,1 0, 1, 2 
SLOT=1 MC16's in slots: 1 Le 2 le 2. 2 
SLOT=2 MC1l6's in slots: 2 2. 2 2, 3, 4 
SLOT=3 MC16's in slots: 3 3, 4 3, 4, -5 
SLOT=4 MC16's in slots: 4 4,5 i. 3, © 
SLOT=5 MC16's in slots: 5 5, 6 4 Os, 7 
SLOT=6 MC16's in slots: 6 b. 7 
SLOT=/7 7 


Turn your amplifier on. 
the volume on your amplifier once you begin playing songs. 


MC16 in slot: 


You are now ready to use your music card. 


Adjust 
If you have an 


MC16 and game paddles, you may wish to begin by running the program 
INTRODUCTION. 


Decide which ENTRY program you wish to uSe. 


Ile or an Apple III, you must use the "ENTRY" program. 
Apple III, you must use the "ENTRY2" program. 


program if you dont. 
an Apple III), you cannot use the INTRODUCTION or ENVELOPE programs. 
the MC16 cannot be used with an Apple III. 


If you are not using an Apple 


If you are using an 


If youre using an Apple Ile, 
you should use the "ENTRY" program if you have game paddles, or the "ENTRY2" 


Note that if you don't have paddles (or if you're using 


Also, 
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OPERATING TIPS 


Never connect this product to any amplifier which may have a hot (electrically 
charged) chassis or case. Severe damage would occur to the computer and the 
amplifier. Plug your Apple and amplifier into the same electrical outlet if 
possible. Differences in ground potentials can cause difficulties when different 
outlets are used. If different outlets must be used, or if the amplifier does not 
nave a three-prong (grounded) power cord, do this: when removing the music card 
from the Apple, always unplug the audio cable from the amplifier first. 
Similarly, plug the music card into the Apple prior to connecting the audio cable 
into the amplifier. 


Always turn the Apple off before inserting or removing any circuit card. 


Any Apple circuit card can be damaged by excessive static. The MCl and MC16 
circuit cards have been carefully designed to minimize the possibility of 
damage. However, walking across a carpet while holding an Apple circuit card 
can charge" you and the card to voltages high enough to damage any electronic 
circuit. Therefore, you should always hold the circuit card in One hand, and 
touch the metal case of the Apple power supply with the other hand DrTOr tO 
Inserting a card in the Apple. This will allow the static charge to be drained 
through the third prong (ground prong) of the power cord, rather than through 
the circuit card and the Apple circuits. 





Should your music card ever need repair, return the entire unit (including the 
audio cable and software) to ALF. Be sure to include a complete description of 
the problem. Replacement parts, such as a new audio cable or Owner's manual, 
can be obtained from your dealer or from the factory. 


PROBLEM CHECKLIST 


1. Use the “reconfigure programs" option from the HELLO (bootup) menu to be sure 
all programs are properly configured. 


¢. If no sound is produced, check the audio cable connections. Make sure all 3 
pins go into the plastic connector. 


3. Check connections to the amplifier and all switch Settings on the amplifier. 
Vo the amplifier and speakers work with other SOund sources? If not, 
replace. 





4. If the disk will not boot, make sure your computer is set up to boot the 
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correct operating system. 


9. When using ENTRY, ENVELOPE, or INTRODUCTION, make sure your paddles are 
plugged in and working properly. (ENTRY2 does not require paddles.) 


6. If you're using an Apple IIe, Apple III, or other computer with lower case 
letters, be sure CAPS LOCK is on. 


COPYRIGHT LAWS 


Federal copyright law permits the owner of this product to make backup copies 
of each disk supplied with the music card. Giving such a copy away or selling 
copies 1S a crime under Federal and state laws. Modifying the programs for use 
with other music cards or for any purpose other than adjusting the programs to 
run on your computer is also illegal. Backup copies must bear a copyright notice 
matching that on the original disk. (A circled C or the word "copyright" 
indicates a copyright on programs or other text, and a circled P indicates a 
copyright on music recordings.) Circle-P copyrights also cover the audio output 
of the music cards while a copyrighted song is being played. 





Other reproduction of these recordings on any media; in data, audio, or any other 
form; with or without modifications; is prohibited by federal law and is subject 
to criminal prosecution. 
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The ENTRY program is used to enter and play songs. Notes, rests, and other 
musical parameters are entered in a convenient sheet-music type format displayed 
on the screen (video monitor), and selected from a "menu" of available notes 
which is also shown on the screen. Songs entered can be stored on (and loaded 
from) cassette tape or disk. A variety of other functions are available for 
editing, stereo selection, and so forth. 


To run this program, you must have 24K or more memory. If you are using a DISK 
Il, you need 32K or more. Very detailed. graphics are presented on the screen, so 
it 1S recommended that a black and white monitor (such as the Sanyo VM4209 or 
VM4215) be used rather than a television set, although good results have been 
obtained using the Sup'r'mod II UHF channel 33 TV interface unit (from M&R 
Enterprises) and the Sony Trinitron model KV 1513 color television. 


You must also have the Apple's paddles plugged in. 


Normally, ENTRY will be set for the correct slot by the boot-up configuration 
program. However, if you wish to change which slot the music card 1s in, you 
may change line 19 yourself. Begin by loading the program, then list line 19. It 
will be 19 SLOT=4 for an MCl1 or 19 SLOT=4 : UNITS=1 for an MC16 (the numbers 
may be different.) Carefully retype the line changing only the appropriate 
Slot/units digit(s) to the proper digit(s) for your system. Now save the program 
on your disk (or cassette tape). 


ENTERING A SIMPLE SONG 


To run ENTRY, type RUN ENTRY and press return (or, from cassette tape, load the 
program and type RUN and press return). The screen will go to hi-res graphics 
mode and display: 
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BERSRRE 1 PART © 2966 FREE 
KEY C 

Ee 
The number in front of "FREE" will vary according to memory size and other 
factors. It indicates the number of notes which can be added, and will be 
constantly updated as you enter and edit the song. 





The first six measures of "America" are shown below: 
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In order to enter tne piece using ENTRY, it is first necessary to break the piece 


up into “parts". Each part is an independent melodic line in which at most one 
note is played at a time. It is best to choose each part so it is consistently 
from the same melodic line in the music. This allows you to select appropriate 
envelope settings for each line later on. The first part, called Part 0, 1S Shown 
below. It is the main melody. 
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To begin entering a new song, type NEW and press return. ENTRY will display 
“NUMBER OF PARTS?", Just press return. This will make the Song have only 1 part 
(part ~). ENTRY now displays “INITIAL SPEED?". Since we don't really know what 
the playback speed should be yet, just press return. ENTRY will assume a Speed 
of 255 (the slowest speed). ENTRY now displays “TITLE LINE 1". If you wish, you 
can type in a line which will be shown on the screen when the Song plays. If 
you're not in the mood, just press return. The title lines can always be entered 
(or changed) later. ENTRY will then ask for title lines 2 through 4. Type titles 
1f you like, or just press return for each line. | = 


Part can now be entered. Note that under "MEASURE 1" the screen Shows ‘KEY 
C’. If you turn paddle 1's knob, a small flying saucer will move up and down to 
the left of the two 4/4's. (If you get paddle Q by accident, then a small arrow 
will move left and right instead. This doesn't matter. Try again with the other 
knob.) This flying saucer is called the “cursor", and it is very important. The 
cursor iS a “pointer" to a particular item in the song. Currently, it is pointing 
to the KEY C before the 4/4. The key of C is a "neutral" key having no sharps 
or flats, and thus shows only as a blank Space right before the 4/4. 


Type KEY:1S and press return. A sharp sign will appear before the 4/4, and the 
cursor will move over to the 4/4. KEY:1S directs ENTRY to write a Key signature 
of 1 sharp (S means "sharp", and F would be used for “flat"). This key signature 
1s written over whatever item the cursor is on. Since it was on the KEY C, the 
KEY C 1S Overwritten with a KEY 1S. 
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When the KEY IS is written, the cursor moves on to the next item in the song, 
which is a time signature of 4/4. The place on the screen which used to show 
KEY C now shows TIME 4/4 since the cursor is over the 4/4. "America" has a 
time signature of 3/4, so type TIME:3/4 and press return. The 4/4 will 
promptly change to 3/4, and the cursor will move on to the next item. The 
Screen now looks like this: 
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You've only been at this for a few seconds, and already you've told ENTRY two 
very important facts about “America', the song youre entering. Without these 
details it would be very difficult to enter the song properly. Why, you're 
probably half way to being a professional musician, if you weren't one when you 
Started. 


Now the cursor is at the first of eight asterisks (*) displayed between the 
treble and bass staves, and the item the cursor is at is a QUARTER 249. These 
eight items are special goodies that describe things about the song which don't 
display well in sheet music format. This particular one indicates how long a 
quarter note should play (249 time units per quarter note). While you will 
eventually want to learn about these, they are not important now, and it is best 
to skip over them at present. This 1s done using one of the paddles. 


Turn one of the paddle knobs back and forth. If the arrow above "MEASURE 1 
PART Q 5996 FREE" moves left and right, you're turning paddle Q@, the “menu 
paddle". If the flying saucer cursor moves up and down, you're turning paddle l, 
the "note paddle". Place the menu paddle (paddle Q) on your left and the note 
paddle (paddle 1) on your right. Usually you'll have your left hand on the menu 
paddle and your right hand on the note paddle; sometimes you'll have to let go of 
the paddles to type on the keyboard (probably not very often). Turning a paddle 
knob with one hand is almost always followed by pressing a paddle button with 
the same hand. You see, turning the knob selects something (a menu item when 
turning the menu paddle, or a note position when turning the note paddle), and 
then pressing the button tells ENTRY to look at the position of the knob and do 
whatever it is set for. Since the two paddles are used for different purposes, 
you always press the button of the knob you have just adjusted in order to 
activate the function you adjusted the knob to indicate. 
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For example, using your left hand only, position the menu paddle so that the 


upward pointing selection arrow points to the right pointing arrow in the menu. 
The screen will look like this: 
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(The position of the flying saucer and the number of notes of FREE Space 
available may be different than shown.) The right pointing arrow is used to 
move the cursor to the right. To cause a right movement, press the menu button 
using your left hand. The cursor will move right from an asterisk meaning 
QUARTER 249 to an asterisk meaning GAP 29 (GAP 65535 on the MC16). To move the 
cursor right again, press the button with your left hand again. The cursor now 
moves to TRANSPOSE @. Press the button several times. The following items will 
appear: ATTACK 8192, DECAY 25, VOLUME 55999, SUSTAIN MQ, and RELEASE 159 for 
the MC1l or: ATTACK 8192, DECAY 50, VOLUME 55900, SUSTAIN MQ, and RELEASE 59 for 
the MC16. Pressing the menu button again moves the cursor past the last of the 
3 asterisks, and END appears under MEASURE 1 to indicate that the cursor 1S now 
at the end marker (that is, at the end of the song). This is where we will begin 
entering the notes of part 9. The screen should now look like this: 
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If it doesn't, you probably didn't start with RUN ENTRY like you should have. (The 
position of the flying saucer and the upward arrow, and the FREE number are not 


important.) Ready to really get into entering sheet music? Here's part @ again, 
just aS a reminder: 
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Using your right hand, turn the note paddle until the flying saucer is on the 
second line from the bottom of the treble Staff, like this: 
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This is where the first note of part @ should be. Still using your right hand, 
press the note button. A quarter note will appear at the second line, and the 
cursor will move over to the right. The pitch for that note is heard if you've 
got your music card plugged in and your amplifier set up right. The screen now 
looks like this: 











 é ee SS > Jae eee 
22 LO © SR: Fee 
ee ee ie 
Ae 


KKKKKRKKK 





a 
‘ 





| 
/ 








wnoda d's at. Hb hs © mse 2 


T 
PE RSURE 1 PART @ 2200 FREE 





Normally when you type in something like TIME:3/4 or when you press the note 
button, the time signature (or note or whatever the cursor is pointing at) is 
written over and thus erased. However, erasing the end marker is not fun, so 
ENTRY automatically inserts the note (or whatever is entered) in front of the end 
marker. Then, when the cursor moves to the right, END is still shown under the 
MEASURE number since the end marker is still there. 


It's time to give your left hand something to do for a while. Just for fun, 
position the arrow under the left pointing arrow in the menu (using the menu 
paddle, of course). Press the menu button. This will cause the cursor to move 
left. Under MEASURE 1, NOTE GN3 249 is displayed. That's the note you entered, a 
G Natural in the 3rd octave (the octave number is an ALF creation and has 
nothing to do with the rest of the world). "Natural" means it is neither sharp 
nor flat. The 249 indicates the number of time periods long the note should be 
during playback. (When you press the note button to enter a note, it is just 
played for as long as you hold down the button.) Remember the QUARTER 249 that 
Said quarter notes should be 249 time periods long? Well, they obviously are. 
Move the menu arrow so it 1s under the move right arrow and press the menu 
button. You're back to the end marker now. Isn't this exciting? 





On to the second note. You've probably still got the note paddle set so the 
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flying saucer is on the second treble line. (If not, move it until it is.) Press 
the note button. The next note is heard and appears on the screen. It is the 
Same as the first note. Now, turn the note paddle until the saucer moves up one 
click to the space above the second line. Press the button to enter this note 
(are you doing all this note-paddle stuff with only your right hand?). Not only 
do you hear this note and see it on the screen, but also a bar appears between 
the note and the flying saucer. This 1s because TIME 3/4 means that there are 3 
(3/) quarter notes (/4) in a measure. Since the measure is now full, ENTRY 
automatically shows a measure bar. You'll notice that there is a bar at this 
point in the sheet music, too. If ENTRY and the sheet music don't seem to agree 
on where to put the bars, then either the sheet music has a typo (that is, a 
wrong note) or you've skipped a note or made some other error. Just by watching 
the measure bars you can be confident that you haven't made any timing mistakes. 


If youre looking ahead at the music for part 9, then you know that the next note 
isn't a quarter note. It's a dotted quarter note, which plays for as long as a 
quarter note plus an eighth note. (A dot always means to add the time of the 
next shorter note to the note length shown.) You may well be wondering why 
ENTRY always makes a quarter note whenever you press down the note paddle 
button. Well, it's because a block is lit up under the quarter note in the menu. 
When you press the note button, a note as long as selected in the menu (shown by 
one or more blocks) is entered. To change from a quarter note to a dotted 
quarter note, you position the menu arrow under the dot, which is just to the 
left of the “3", and press the menu button (left hand, remember?). A block 
Instantly appears under the dot, and the block under the quarter note remains. 
The screen now looks like this: 
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Okay, fire away. Move the note paddle down two clicks to the Space under the 
second treble line, and press the note button. You see how you switch between 
the left and right hand, usually rotating a knob and pressing a button with the 
Same hand? Since you generally keep your hands on the two Knobs, you can enter 
notes really fast. You don't even have to look at the screen when you are 
entering several notes of the same length, because you can just count the 
"clicks" the Apple's built-in speaker makes at each line or Space on the staff. 
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To enter the next note, position the menu arrow to the eighth note and press the 
button (I'm not going to remind you to use your left hand, since you've probably 
got that all straight by now). The blocks under the quarter note and the "dot" go 
out, and one appears under the eighth note, like this: 
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Move the note paddle up a click to the second line, and press the button to enter 
the eighth note. [The screen now looks like this: 
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Let's take a look back. Move the cursor left one. (You know how to do it, we 
just did it a while back to see the first note displayed as NOTE GN3 249.) The 
eighth note shows up as NOTE GN3 120. It's the same as the first note in this 
part except it's half as long (only 129 time periods). That dotted quarter note 
we're coming up to should be a quarter (249) plus an eighth (12%) long. Back up 
again to see it. Yep, NOTE FS3 36%. But wait, doesn't FS3 mean an F sharp in the 
3rd ALF octave? We didn't enter a sharp note. The reason for this is that the 
key signature indicates that all F's should be sharp. So, ENTRY automatically 
enters F's as being sharp, without the user having to specify it. Of course. 





Back up three more times to get to the first note. Now, position the menu 
pointer to the rightmost menu item, a little speaker with a right arrow under it. 
Press the menu button, and a small block appears under the speaker/arrow. 
Curious? Position the arrow for right movement, and press the menu button five 
tines to go past all the notes (do it fairly slowly, and pause a little extra at 
the dotted quarter note). You'll hear the first 5 notes of "America". The 
Speaker/arrow activates playback during right movement. The timing of the notes 
is still dependent on how long you press a button down, but don't worry. It won't 

be during playback. You don't believe me, do you? All right, type PLAY:P and “ 
press return. ENTRY shows "SET SPEED (255) AND PRESS BUTTON". Crank the menu 
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paddle up all the way (it may not actually get up to 255, but who cares?). ENTRY 
doesnt happen to mention which button you should press, but it is the menu 
button. Trust me. Punch it and ENTRY will play the song. A little slow, perhaps, 
but well know better next time. 


Let's put in another note. I'll bet you're thrilled at the prospect. Just select a 
quarter note using the menu paddle, flash the note paddle up to the space above 
the second treble line, and punch the note button. Here's a screen image just to 
make sure were together: 
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Click up one to the third line. We're already set for quarter notes, so press the 
note button. Twice. Now, click up and press again (you should take a look at the 
music for part J again so you'll know what you're doing). That completes another 
measure. The display now shows MEASURE 4. This means the cursor is pointing to 
an item which is in the 4th measure. In this case, it 1s the end marker which is 
indeed in the 4th measure. 





Faster now. Set for dotted quarter. Down a click and punch. Switch to eighth. 
Vown a click and punch. Now quarter. Down a click, punch, up a click, punch, 
down, punch, down, punch. Last measure. Set for dotted half. (In case you 
havent noticed, you can't set for “dot" and then "half" because "half" turns of f 
“dot". Set "half" first, tnen "dot".) Okay. Up a click, and punch. We're out of 
music (just the first 6 measures, remember?). Are you getting fast at it yet? 
You will. It's easy. Let's see the screen now: 
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Type PLAY:P and press return. Let's try a speed of about 200 now. Adjust the 
menu paddle to some number in the vicinity of 299. (Don't get too picky, it's not 
Important to get exactly 299.) Punch the button, and the first 6 glorious 
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measures issue forth. 


Rapture! Ecstasy! Sublime delight! (Where's my thesaurus?) Ah, the joys of music. 
And yet, that's just one part. Let's get on to THREE PARTS. Quick! 


Fortunately, it 1S quick. First, we have to tell ENTRY that we want to add a 
second part. Type EDIT and press return. ENTRY responds by showing: 





wre dd DPR. Hb 4 + «neon? 


MEASURE a PART @ ~3890 FREE 
veers OF PARTS? 


Since we want 2 parts, type 2 and press return. ENTRY then asks for the “initial 
speed". We've found the speed should be 209, so type 20% and press return. 
ENTRY will then display each of the four title lines. Just press return each 
time. The screen now shows: 
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This is the beginning of Part 9, the part you just entered. The part just 
created is Part 1. To see Part 1, type PART:1 and press return. The screen 
Shows: 
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This is just like Part Q@ looked originally, except there are fewer notes of 
"free" memory, and the screen shows "PART 1" instead of "PART §". You now 
proceed in the same fashion as before. Type KEY:1S (return) and TIME:3/4 
(return). The music for Part 1 is as shown below: 
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Use the right arrow function to skip over the eight asterisks, and enter the 
first three notes as usual. The screen should now look like this: 
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Type PLAY and press return. (Now that we've set the appropriate “initial speed", 
we can type PLAY for automatic playback rather than PLAY:P for paddle-controlled 
tempo.) You'll notice that only the first measure is played. Playback always 
stops when the end of the highest numbered part is reached. Since we've only 
entered the first measure in Part 1, and Part 1 is the highest numbered part, 
only the first measure is played. Enter the remaining notes of this part in the 
usual fashion. The screen will look like this: 
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Type PLAY and press return. If there are any wrong notes, back up and correct 
them. (More details on correcting wrong notes will be given later in this 
section.) You're now ready to enter the third part. 


Type EDIT and press return. Ask for 3 parts this time, and then press return to 


Skip the other questions. When Part Q appears, type PART:2 to go to the third 
part. The screen shows: 
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Begin as usual, typing KEY:1S and TIME:3/4, then skip the asterisks. Just for 
fun, type PLAY and press return. There is a brief flash, then the hi-res 
graphics screen reappears. This is because the end of the highest numbered part 
(now Part 2) is reached immediately, since there are no notes entered in it yet. 
Now comes your big chance to use the "bass staff", which has been ignored up to 
this point. The bass staff is the lower five horizontal lines. The sheet music 


for Part 2 1S shown below. 
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Enter the first note. The screen now shows: 
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Enter the next nine notes. Ihe screen shows: 
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The next note 1s sharp, so use the menu paddle to light up the sharp sign in the 
menu, like this: 
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Now enter the note. The sharp sign in the menu disappears into hyperspace: 
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Enter the rest of the part. The screen shows: 
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Type PLAY to hear the song and check for errors. 


CORRECTING MISTAKES 


Back up to the first note in measure 5 (of Part 2). Let's say we want to change 
this note so it is at the next space up on the staff. First, set the menu notes 
for a quarter note, and put the cursor in the space above the note: 
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Now just press the note entry paddle button (paddle 1, of course). The old note 
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is written over by the new note: 





REST © 4 . DPBS. 3 t b . — = ween & 
MEASURE = PART 2 3333 FREE 
NOTE DN2 246 

$8 


The rest of the song is not affected. Now, let's say we want to change the next 
note in the measure into a half note of the same pitch. Set for half note, 
position the cursor so it is over the quarter note's head (in order to get the 
Same pitch), and press the button: 
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What if we want to get rid of the first note in measure 6 (where the cursor is 
now)? Just position the arrow for "DEL" and press the menu paddle button: 
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Now, let's change our mind and put it back. It was a quarter note, so set for 
quarter. Position the cursor on the middle bass staff line to get the same 
pitch. We need to insert the note, so put the menu arrow under "INS" and press 
the menu button to light up a block under it. Now just press the note button to 
enter a note as usual. Instead of replacing the note the cursor is at, the 
entered note will be inserted in front of it because "insert" mode is on: 
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Click the note paddle up one, and press the note button again. Another note is 
thus inserted: 
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Now press the menu button while the arrow is pointing at "INS". The block of 
light goes off. Enter a note. Since "insert" mode is no longer on, the old note 
is replaced by the new one. Next, back up one and delete the last one of the two 
Similar quarter notes so the next demonstration will be more clear. Let's change 
the remaining quarter note to a half note. We could set for half note and 
reenter a half note over the old quarter note, or. . . leave the menu setting at 
quarter note, aim the menu arrow at ‘TIE", and press the menu button. There is 
a beep, and the cursor backs up. Now press the menu button once more to do 
"TIE" again. The current setting (quarter note) is added to the note the cursor 
is at. Since it was originally a quarter note and we added a quarter note, it 
becomes a half note. (Note: the first time you pressed the button for "TIE", the 
cursor was not at a note or a rest, so the tie could not be done. Since you 
usually tie the last entered note, ENTRY backs up one when you do an illegal tie, 
allowing you to just press the button twice to tie the last note.) Now set the 
menu for a sixteenth note. Aim at "TIE" and press the button twice. The note is 
now a half note tied to a sixteenth: 
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The vertical position of the note paddle cursor is not important during a "tie" 
Since the note paddle is not used. It is important to note that although the half 
note tied to a sixteenth note is shown as "two" notes, it is really only one. If 
you back up and look at it, you will see that the length shown is 549 time 
periods, which is a half (480) plus a sixteenth (69). In fact, the little curved 
line between notes always means that the multiple notes shown are really only 
one note. This happens on tied notes and on notes that have part of their 
duration in one measure and the remainder of their duration in the next measure. 
Tie in a sixty-fourth to the last note, and you'll see that more than two "notes" 
can be tied together to display a single note: 





In general, mistakes are corrected (or any desired changes are made) by using 
the above functions (change a note, insert a note, delete a note, and tie 
additional duration to a note) until the screen shows what you want. When using 
these functions, only the current part is affected. In fact, the only functions 
avallable in ENTRY that affect anything besides the current part are the NEW, 
EDIT, STEREO, and SPEED commands which by their very nature must relate to the 
entire song. 





ENTERING RESTS 


Qn occasion a part must sit around for a while and not play anything. This is 
called a "rest". Rests are entered in much the same fashion as notes. There are 
two main differences: the vertical position of the note cursor doesn't matter 
(since rests don't have any "pitch"), and the menu paddle is used to enter a rest, 
rather than the note paddle. Obviously, you point the menu arrow to "REST" and 
press the menu button to enter a rest. The duration of the rest is determined 
by the menu, just as the duration of a note is. Rests are displayed with 
different symbols than notes. They correspond like this: 
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Lets start on a new song. (Actually, "song" refers to a musical composition with 
lyrics. Technically, one shouldn't use "song" to refer to just any melody, but 
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there isnt any simple word available. Musicians use "piece" or "work", 
apparently in an effort to avoid any disclosure that music is involved. In fact, 
all artists use "piece" and "work" to describe their creations.) Type NEW and 
press return. Press return 6 more times to avoid answering the useless 
questions. Skip over the key and time signatures, and the eight asterisks. 
Select quarter note, and press a REST. A quarter rest appears on the screen. 
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Now select sixteenth note duration and tie it onto the quarter rest. Oddly 
enough, the screen shows: 
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In traditional music notation, rests are never shown as being tied. This is 
because there is no difference between, for example, a half rest and two quarter 
rests during performance. The ENTRY screen display makes no distinction 
between a rest which is as long as a quarter plus a sixteenth, and two rests the 
first of which is a quarter and the second of which is a sixteenth. However, it 
takes only one “right movement’ to skip a single tied rest, and two to skip past 
two individual rests. (Plus, two rests would take twice as much memory as a 
Single rest.) Incidentally, when a large number of rests are tied together (for 
example, in a part which doesn't begin playing until far into the song) the cursor 
will be at the last of the rests displayed, and the measure number will reflect 
the measure number the rest starts in. (This is true of notes, too.) 


SUBROUTINES 


Most people are familiar with the song "Row, Row, Row your Boat". If you're not, 
become so. This song plays the same theme several times, and from several 
parts. It seems that one would have to enter this theme several times. Since 
repeated sections such as this are common in music, ENTRY has special 
provisions for entering them. The sheet music for this song is thus: 
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This theme must be entered in a special fashion which allows it to be played 
many times. This 1s done using a subroutine. Type NEW and press return several 
times (as usual) to start fresh. Now type SUBROUTINE: and press return. The 
screen will show: 
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Type KEY:2S and TIME:2/4 to enter the key and time signatures. (Otherwise KEY:C 
and TIME:4/4 are assumed.) Enter the first four measures of the theme in the 
usual fashion. You'll notice that the next note is a triplet. Triplets are entered 
in the same fashion as dotted notes. Just light up the block under the "3" after 
selecting eighth note. Now press the note paddle button to enter the note. The 
Screen will show: 
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The little 3 above the note indicates that it is a triplet. Conventional sheet 
music notation shows triplets with a curved arc above the three notes and a 
Single 3. ENTRY puts a little 3 above each note. This is because ENTRY, unlike 
conventional notation, allows the presence of a single triplet note (that is, a 
Single note with a duration equal to one of the notes of a conventional triplet 
set). Press the note button twice more to enter the remaining two triplet notes 
of that pitch, then enter the remaining three sets of triplets, and the rest of 
the theme. The screen will show: 
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Now type PART:@ and press return to go to Part 9. Type KEY:2S and TIME:2/4 as 
usual, and skip the 8 asterisks. Now type CALL: and press return. A 9th 
asterisk appears. During playback, this CALL causes the theme entered into its 
associated subroutine to be played. (CALL:1 would play the theme entered into 
SUBROUTINE:1.) Type PLAY and press return. The basic theme is played. Now, type 
in another CALL:9 after the first one. Type PLAY again and note that the basic 
theme is played twice. 


Now EDIT the song to 2 parts. Type PART:1, KEY:2S, and TIME:2/4. This time, 
instead of skipping the 8 asterisks, step forward until TRANSPOSE 9% is shown. If 
we played the basic theme exactly the same in both parts, they would be hard to 
tell apart. So, type TRANSPOSE:24 and press return. The TRANSPOSE Q is of 
course thus changed to TRANSPOSE 24. The transpose function raises all 
following pitches by the specified amount of quarter steps. There are 24 
quarter steps per octave (2 quarter steps is the difference between two adjacent 
keys on a piano, including both black and white keys), so TRANSPOSE:24 will cause 
this part to be played one octave higher in pitch than the other part. Skip over 
the remaining asterisks. Part 1 is supposed to begin after Part @ has already 
been playing for two measures. Select a whole note duration and enter a rest. 
It will show as two half rests due to the 2/4 time signature. Now type in two 
CALL:~'s. Type PLAY. A two-part round will be played. 





Let's add a third part. EDIT the song to 3 parts. Type PART:2, KEY:2S, and 
TIME:2/4. Skip to the TRANSPOSE setting again. Let's shift this part down one 
octave. Oddly enough, to transpose down you take the number of quarter steps 
you wish to transpose down, and subtract that number from 256. 256-24 is 232, 
SO type TRANSPOSE:232. Now skip past the other asterisks. Punch in a whole 
rest, then press TIE twice to make it two whole rests (which will display as 
four half rests, again due to the time signature). Type in the usual two 
CALL:~'s. Now just type PLAY to hear the full three-part round. 


Perhaps you've noticed that you really didn't need the KEY:2S's in the three parts, 
Since there arent any notes anyway. You could have simply deleted the key 
Signature if you prefer. However, often there are notes in the part, and in that 
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case the key signature would be needed. In this particular instance, even the 
time signature could have been deleted without affecting the song. Naturally, the 
KEY:2S was needed within the subroutine, else the notes of the song would be 
incorrect. 


Here are a few things you should know about subroutines. You can have 199 
Subroutines numbered 9 through 99. Always begin with subroutine @ and proceed 
by l’s. If you press RESET, or if you save a song and load it again, all the 
Subroutine numbers will be readjusted so they do begin with Q and proceed by 
l's. A subroutine is created when the first SUBROUTINE command using its number 
is entered. All subsequent SUBROUTINE commands with that number merely cause 
the subroutine to be displayed and to be available for editing. (That is, the 
first SUBROUTINE command for any given subroutine is like the EDIT command for 
new parts. All future SUBROUTINE commands are like the PART command for 
parts.) Once created, a subroutine cannot be destroyed. The most you can do is 
delete everything in it. A CALL can be entered only to an existing subroutine. 
(That is, you can't even enter a CALL to a subroutine you haven't created yet.) 
Subroutines are not limited to notes and rests. You can put a TRANSPOSE function 
in a subroutine, for example. Some things, like key and time signatures, can be 
put in a subroutine to affect the notes entered in the subroutine, but they do 
not affect the notes entered outside the subroutine, even after a CALL to the 
Subroutine. The summary of commands in this section tells the effects of each 
command. 





Subroutines can be used in a much more complex fashion than shown in this 
Simple example. For example, subroutines can contain CALLs to other subroutines. 
If a subroutine contains a CALL to itself, the song will repeat forever (unless 
the highest numbered part does not use a subroutine which CALLs itself, in which 
case the song will stop whenever the highest numbered part stops). NOTE: be 
Sure there is at least one note or rest in a subroutine that CALLs itself; 
otherwise the playback routines will not continue processing all parts. 


LOADING AND SAVING SONGS 


If you want to save Row, Row, Row then you should type SAVE and press return, if 

you want to save it on cassette tape. When saving a song to disk, it is 

necessary to specify a name. For example, you could type SAVE:ROW and press 

return. Names can contain any characters except comma, and can be up to 28 
characters long. (Control letters and trailing spaces are ignored.) Disk 
Specifications like ",D2" or ",S3,D2" can be added after the name if needed. Note 

that songs will appear in the catalog as Integer BASIC programs (even if your 

System doesn't have Integer BASIC) and will have names that begin with "M:". -~ 
Songs are loaded the same way, using LOAD instead of SAVE. 
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The music card is supplied with a few sample songs which can be loaded and 
played. Additional songs are available at extra cost. 


ADJUSTING THE TEMPO 


Let's say we want to enter the "row" theme to play twice as fast with the same 
initial speed setting ("initial speed" is changed to make smaller adjustments). 
That means each note will have to play for half as many time periods. Type NEW 
and press return as required, enter the key and time signatures, and you'll be at 
the QUARTER 249 function. Type QUARTER:129. This will make all quarter notes be 
entered as 12 time periods instead of 249 (and thus take half the time, so the 
song will play twice as fast). The other menu notes' duration values will change 
proportionately. Skip over the other asterisks and enter the theme. Now type 
PLAY. The song does indeed play twice as fast. Type PART:@ to get back to the 
beginning of the part, and skip over to the QUARTER function. Change it back to 
QUARTER:249. You'll notice that all previously entered notes show as notes half 
as long as originally entered. Examine any note by moving the cursor to it. 
Notice that the length in time periods is still the same. You didn't change any 
of the notes, only the QUARTER function, so of course none of the notes have 
been altered. Obviously ENTRY stores notes based on their “time period" length, 
and just computes the proper note to display based on the QUARTER Setting. (And 
the QUARTER setting determines the “time period" length of notes when they are 
entered.) Since none of the notes have been changed, the song will still play as 
it did before. In fact, you can skip right a measure or two (you might want to 
look up the MEASURE command in the summary of commands) and insert a 
QUARTER:129. Notes before the QUARTER function will be shown as half as long as 
originally entered due to the QUARTER:249, and notes after the QUARTER:129 will 
be shown as entered. None of this affects playback, but any new notes you might 
enter would be based on the current QUARTER setting. Remove the inserted 
QUARTER, if you put one there, and change the QUARTER at the beginning to 
QUARTER:129 as it was when the notes were orignially entered. Now type SPEED:2 
and press return. This will multiply the "time period" lengths of all notes in 
all parts and subroutines by 2. Rest durations and QUARTER Settings are also 
multiplied by the specified amount. Now the song plays twice as slow (also known 
as half as fast). In fact, it should look just like the Original QUARTER:24@ 
version, except that it used a subroutine and multiple parts. (CAUTION: the SPEED 
command can be tricky to use. See the complete description in the summary of 
commands.) 





By typing in a QUARTER function wherever you need a different tempo, you can 
make the song play at different speeds from section to section. Just remember 
that the QUARTER function affects only notes which haven't been entered yet. 
Another way to get unusual note durations is by using the LENGTH command. Let's 
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Say you want to play five notes in the space of a single quarter note. A 
Standard quarter note is 249 time periods long, so each of your five notes will 
have to be 249/5 or 48. Unfortunately, there aren't any menu notes that are 48 
time periods long. So, type LENGTH:48. The block(s) under the menu notes 
disappear to indicate a non-standard note length. All notes (and rests) you enter 
now will be 48 time periods long. Give it a try by making a new song and 
punching in five notes. The screen should look like this: 
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Since there is no representation for a note 48 time periods long, each note has 
a small X. To cease entering non-standard notes or rests, just activate any menu 
note. For example, put the menu arrow under the half note and press the menu 
button, then do the same for the dot (".") to select a-dotted half note. Punch in 
a note, and the screen shows: 
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The measure bar shows that a full 4 quarter notes worth of duration have 
occured, verifying that the five funny notes took up one quarter note of time. 


ENVELOPES 


Envelopes are a little complicated, and to really get the most out of your music 
card 1s going to require a little study, some effort, a fair amount of 
calculation, and an awful lot of experimenting. Let's start at a very simple 
level. "Envelopes" are volume contours of each note. Since the word "volume" is 
used to mean the volume over several notes, we use the word "loudness" to refer 
to changes within a note. Both "volume" and “loudness" refer to the strength of 
the sound signal, but volume is used for long time durations (over several 
notes), and loudness is used for shorter durations (usually during a single note). 
“Amplitude” is used for the strength of the signal at any given instant, but this 
does not concern envelopes. 
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Let's begin with a typical note, one which begins with a loudness of zero (no 
Sound) and also ends with a loudness of zero. In a simple sound, say that of a 
plucked string, the loudness rises very fast when the string is first plucked. 
Then, as the string vibrates, the loudness slowly dies out. The rising part of 
the envelope is traditionally called the "attack" stage. The falling part (where 
the loudness dies out) is called the "decay" stage. The whole envelope is called 
an AD (attack-decay) envelope. 


In an AD envelope, there are three parameters. The first is the "attack rate", 
which is how fast the loudness goes from zero up to its highest point. The 
second we call the “volume level", which is the loudness level at the highest 
point. The third parameter is the "decay rate", which is how fast the loudness 
goes from the volume level back down to zero. For an AD envelope, the attack 
rate 1s usually very high (very fast). Plucked strings, for example, reach 
maximum loudness almost instantly. The decay rate can be varied for different 
sounds. A relatively fast decay creates a quick pluck for an instrument which 
decays quickly, like a banjo for example. A relatively slow decay creates a 
Sound which dies out very slowly, more like a piano while the key 1S held down. 


A more complex envelope is the ADSR (attack-decay-sustain-release) envelope. In 
the ADSR envelope, the attack stage is the same as in the AD envelope just 
described. However, the decay stage does not necessarily drop down to zero. 
Instead, it drops down to a selected level, called the "sustain level". Usually 
the sustain level is very high, nearly as high as the volume level. The loudness 
remains at the sustain level until something causes the "release" Stage to begin. 
Usually the release stage begins a certain time before the next note. The 
release stage is the same as the decay stage of an AD envelope, except it drops 
from the sustain level (rather than the volume level) to zero. You'll notice that 
an AD envelope is just an ADSR envelope with a sustain level of zero. ADSR 
envelopes are useful for instruments which can play a note at a high volume 
level throughout the note, such as woodwind and brass instruments, or organs. 
The attack-decay stage of the ADSR envelope is used to give the sound an initial 
‘thump" when desired. If the thump is not desired, the sustain level and volume 
levels are set the same. 


Envelopes are controlled by the ATTACK, DECAY, SUSTAIN, RELEASE, VOLUME, and GAP 
commands. Both VOLUME and SUSTAIN specify a loudness level. SUSTAIN:@ selects a 
very low level (soft), and SUSTAIN:65535 selects a very high level (loud). ATTACK, 
DECAY, and RELEASE specify a rate of change. ATTACK:@ selects a very slow 
increase rate, and ATTACK:65535 selects a very fast increase rate. (Actually, 1 
1s very slow. § is stopped, or no change.) A blank Song created with the NEW 
command contains some envelope settings which are useful for testing songs. 
Usually you enter the basic notes of a song, play around with the tempo 
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(playback speed) if necessary using SPEED commands and/or different QUARTER 
settings, and once you're satisfied with the tempo you go on to the envelope 
settings. This is because the SPEED command doesn't change any of the envelope 
Settings. If you perfected your envelope settings and then used a SPEED 
command, the envelopes would no longer be. perfect. This is needlessly complex 
to correct, so it is best to get the tempo going right before starting in on 
envelopes. 


To change the initial envelope settings, just position the cursor at the 
appropriate item and type in a new value. For example, if you wish to have a 
Slower attack rate, you might position the cursor at the ATTACK 8192 and type 
ATTACK:/809. Few songs use the same envelopes on all parts or even the same 
envelope throughout any particular part. At any point in a part, you can just 
“insert new envelope parameters. During playback, the most recent setting (for 
each part) is used for envelope production. Since there are notes (and rests) 
between one envelope specification and another, the playback routines will not 
“see the later specifications in the part: until the note before them is finished. 
When they finish a note, they look at the next thing in the part. If it's not a 
note or a rest, they make whatever change is requested (a new attack value, for 
example) and then continue with the next thing in the part (until a note or rest 
is finally found). 





Usually, on a synthesizer or a piano, the sustain stage ends (and the release 
Stage begins) whenever the key being pressed is released (hence the word 
“release', obviously). There aren't any keys to release in the music data. So, 
the GAP function is used. It 1S used to specify how long before the end of the 
note the release stage should begin. For example, using QUARTER:249 settings, a 
whole note (969 time periods) played with a GAP setting of 249 would have three 
quarter notes (969-249, or 72 time periods) worth of attack, decay, and sustain; 
then one quarter note (249 time periods) worth of release. A rest automatically 
Starts the release stage if it wasnt already. Notes shorter than the GAP setting 
have no release stage unless followed by a rest. GAP:65535 is used when no 
automatic release stage is desired. 


Now 1S the time for all good men to experiment with envelope settings. Don't 
come back to this manual without experimenting for at least 7 million time 
periods. 


You are now ready for the serious explanation of envelope production. Although 
theories change from time to time, today's leading scientists in enveology agree 
on the "wandering loudness" explanation. This one seems to fit the reality of 
the music card most closely. The two main ingredients of this are “current 
loudness" and "desired loudness". The current loudness refers to a number which 
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ranges from ~ to 65535. This number divided by 4996 (256 on the MC16) is the 
actual volume setting on the music card at the moment. The desired loudness is 
also a number from @ to 65535. The current loudness is "attracted" to the 
desired loudness, so it attempts to get closer and closer to it. Once each time 
period, the current loudness can increase by an amount less than or equal to the 
attack setting, or it can decrease by an amount less than or equal to the 
“current decay" setting. (Not to be confused with the "decay Setting".) In this 
fashion, it will arrive at the desired loudness as quickly as the attack/current 
decay settings permit. Once the current loudness collides with the desired 
loudness, the desired loudness spontaneously changes to a new value, called the 
“Current sustain level" (not to be confused with the "sustain Setting"). 
Probability states that the new desired loudness may be different than the 
current loudness (although the current loudness is equal to the old desired 
loudness), so the current loudness must again seek the desired loudness. This 
astounding natural process continues at all times during playback. The current 
loudness cannot be affected directly, so it must be "guided" by selecting 
appropriate parameter settings. 


Notetrinos generated using a high-power paramatron at the University of Northern 
south Dakota (just across the border from Hoople) have revealed the Following 
characteristics of these settings. (What?) When a new note begins, the most 
recent decay setting is written into the "current decay" rate, the most recent 
volume setting is written into the "desired loudness", and the most recent 
Sustain setting is written into the "current sustain". This causes the attack and 
decay stages of the envelope to occur, since the current loudness (and thus the 
music card volume) will raise (at the attack rate) to the selected volume level, 
at which time the sustain level becomes the new desired loudness, causing the 
current loudness to drop to the sustain level (at the decay rate). Once the 
Sustain level is reached, the desired loudness stays constant (Since it is equal 
to the current sustain setting which would normally become the new desired 
loudness) and thus the sustain Stage of the envelope occurs until Something 
Changes. 


Something changes when either (a) the time remaining for the current note equals 
the most recent GAP setting, (b) a rest is encountered, or (c) a new note is 
encountered. Case (c) has already been discussed (above). In either case (a) or 
(b), the release stage must begin. This is done by writing the most recent 
release setting into the “current decay" and a zero into the "desired loudness" 
and “current sustain". The current loudness (and, again, thus the actual music 
card volume) then naturally drops to zero at the selected release rate. 


This simple process generates a variety of complex envelopes, for single notes 
or for several. Be ye not confused: each note does not necessarily have an 
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"attack" and "decay" stage (and so forth). In fact, if the current loudness is 
greater than the latest volume level when a new note begins (for example, the 
volume setting was just lowered drastically before this note, and the previous 
note had been at a very high volume with too slow a decay/release rate to drop 
very far), the note would begin with a "decay" stage, since the current loudness 
would have to go down to intercept the desired loudness (which would be the new 
volume level). Thus, the envelope parameters are not limited to a single note. 
In general, however, one will arrange the parameters so the envelope will be 
limited to a single note. 





Some examples are in order. Let's say we want a simple AD (attack-decay, or 
ping") envelope with a volume level of 55999. Further, let's say it is a quarter 
note with standard QUARTER settings (249 time periods) and we want the first 
loth of the note to be the attack stage, and the remaining 15/16ths to be a full 
decay. The attack rate will have to be designed to take the current loudness 
from ~ to 55999 in 249/16 time periods. 55999/(240/16) is 3666.67 so we want an 
attack setting of 3667. The decay rate will have to take the current loudness 
from this peak of 55999 back down to @ in 249*15/16 time periods. 
55090/(249*15/16) is 244.44 so we want a decay setting of 245. The loudness 
contour will appear thus: 
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The GAP setting must be 65535 to avoid a release stage. Now, what if we played 
an eighth note with this setting? The loudness contour would appear thus: 
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If an eighth note is followed by a rest, the release stage will begin. Therefore 
the release setting should be set to the same as the decay setting, unless you 
want something different to happen on notes followed by rests. What if we 
played a whole note? Behold: 
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This assumes the sustain level was set to —. What if it were 45990?: 
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This is almost an ADSR (attack-decay-sustain-release) envelope. All we need is 
release. Let's say we want it to take half as long to release as the quarter 
note example took to decay. That means we'll need a release rate which is twice 
as fast, or 2*245 which is RELEASE:499. Now, it will take 45990/499 time periods 
for the current loudness to drop from 45999 (the sustain level) to 9, so we need 
a GAP setting of 45999/499 (which is 92) or greater if we want the release to go 
clear down to zero. That looks like this: 
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The sustain level need not be less than the volume level. For example, with a 
Sustain level equal to the volume level, you get an attack-sustain-release 
envelope (organ like, using fast attack and release rates). 


Experiment more with the settings. Draw graphs like the ones above if they help 
you. Look at other people's envelope settings if you run out of ideas. Here's a 
real tip: program what would normally be a whole part into a subroutine instead. 
Then you can call it from two parts, and use different envelope settings on each 
part (don't put envelope settings in the Subroutine!). This will let you make more 
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complex sounds, especially using different transpose settings or by putting a 
Short rest before the CALL in one of the parts to delay it slightly (for an 
"echo" effect) or both. 


BEAMING 


In conventional sheet music notation, groups of notes shorter than quarter notes 
are often connected together with "beams". This makes them easier to read 
during performance. The beamed notation can easily be translated into regular 
"flagged" notation as shown below. ENTRY uses the flagged notation because it 
requires less memory per note, and can be entered more quickly. 


IF WRITTEN: ENTER: 


ds= ss ahh 

bids = sis d = dd) 
bil = JIT I = BSKS 
JJ = JIL = DRS 
edd = ss d= dS 
rddd = ds IL = KK 


etc. 
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SAMPLE SONG BREAKDOWN 
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SUMMARY OF COMMANDS 


ENTRY has four types of commands. They are: 

1. Commands which are done immediately and have no effect on the song data. 

¢. Commands which are done immediately and have an effect on the song data. 

3. Commands which are stored in the song data and do not affect playback 
directly. 

4. Commands which are stored in the song data and do affect playback directly. 





All commands, except those entered using the paddles, are typed in using the 
Apple keyboard in the following fashion. Each command has a "keyword", for 
example NEW or VOLUME. Some commands have one or more parameters, in which 
case the keyword is followed by a colon (:) and the parameter, for example 
VOLUME:55~90. Thus, a command is always entered by typing the keyword and 
pressing return; or by typing the keyword, a colon, one or more parameters, and 
pressing return. (Do not type any spaces.) Since the keyword is always followed 
by a return or a colon, ENTRY has been written to allow abbreviation of the 
keyword. You can shorten any keyword as much as you like, as long as there are 
still enough letters to tell it apart from any other keyword. For example, 
VOLUME can be shortened to just V since no other keyword starts with V. 
SUBROUTINE can be shortened to SUB, but not to SU since it could then be either 
SUBROUTINE or SUSTAIN. An example of a complete abbreviated command is SUB:@ 
instead of SUBROUTINE:@. The right and left arrows on the Apple keyboard can be 
used to backspace and to forward space for error correction. When return is 
pressed, only itetters to the left of the flashing cursor are considered part of 
the command, other letters are ignored. Control X can be used to clear the line 
and start over. 


In the bold type for each command, anything inside <broken brackets> is an 
explanation rather than something to be typed literally. Anything inside 
[brackets] is optional. 


TYPE 1 COMMANDS 


These commands are done immediately. The song data is not changed at all. 


odds TRS. , 


The seven note duration symbols, plus "." and "3", are used to select a new note 
entry duration. (See REST and PADDLE 1 under Type 4 Commands.) They are 
requested by pressing Paddle #'s button while the upward-pointing arrow is 
aiming at the desired symbol. When one of the seven note duration symbols is 
requested, a block is lit under it. All other blocks under note duration symbols 
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(including "." and "3") are turned off. When "." is requested, the block under it 
changes (becomes lit if it wasn't, or is cleared if it was lit). When "3" is 
requested, the block under it changes. 


# b & 


The three accidental control symbols are used to select accidental control for 
future note entry (see PADDLE 1 under Type 4 Commands). They are requested by 
pressing Paddle Q's button while the upward-pointing arrow is aimed at the 
desired symbol. When one of the accidental control symbols is requested, the 
block under it is changed (becomes lit if it wasn't, or is cleared if it was lit) 
and the blocks under the other two accidental control symbols are cleared. 





—_— 


The left and right movement controls are used to move the cursor left or right. 
They are requested by pressing Paddle #'s button while the upward-pointing arrow 
is aimed at the desired symbol. When one of the movement control Symbols is 
requested, the cursor will move one item in the indicated direction. Movement to 
the left of the first item in a subroutine or part is not allowed. Movement to 
the right of the end marker in a subroutine or part is not allowed. When a 
movement is requested which is not allowed, the request is ignored and the Apple 
Speaker will beep. | 


INS 


The insert symbol is used to turn insert mode on or off. It is requested by 
pressing Paddle 9's button while the upward-pointing arrow is aimed at INS. When 
requested, the block under INS is changed (becomes lit if it wasn't, or is cleared 
if it was lit). "Insert mode" is on when the block under INS is lit, or when the 
cursor is at the end marker of a part or subroutine. All Type 3 and Type 4 
Commands are affected by insert mode. 


> 


cna 


The speaker/arrow symbol is used to select playback during forward (right) 
movement. It 1s requested by pressing Paddle Q's button while the upward- 
pointing arrow is aimed at the speaker/arrow symbol. When requested, the block 
under the symbol is changed (becomes lit if it wasn't, or is cleared if it was 
lit). When lit, notes moved past with the right movement Symbol, and notes 
deleted with the DEL symbol, are sounded through the music card. 


FP 
The FP command is used to exit ENTRY and return to BASIC. The current song 
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data 1s lost. Note that after FP is used to exit ENTRY, it cannot be rerun Simply 
by typing RUN. It must be reloaded (using RUN ENTRY) to be run again. Sample 
command: FP (return). 


GOT 0:<p-8> 

The GOTO command is equivalent to the PART command (a Type 1 Command) except 
that a MEASURE command (a Type 1 Command) is automatically performed after the 
indicated part has been selected. The measure number used for the MEASURE 
command is whatever measure number was displayed on the screen at the time the 
GUTQ command was entered. Sample command: GOTO:1 (return). 


LENGTH:<9-65535> 

The LENGTH command is used to select a non-standard note duration. (See PADDLE 
Y and PADDLE 1 under Type 4 Commands.) When entered, all blocks under the 
seven note duration symbols and under "." and "3" are cleared. The indicated 
duration is saved for future note and rest entry use. Sample command: LENGTH:48 
(return). 





ME ASURE:<9-65535> 

The MEASURE command is used to view a particular measure within a part or 
Subroutine. The cursor moves to the first item within the specified measure 
number. MEASURE: is equivalent to MEASURE:1. If no such measure exists, the 
cursor iS moved to the end marker of the part or subroutine. Sample command: 
MEASURE:249 (return). 


PART :<f-8> 

The PART command is used to view a particular part (and thus select that part 
for possible editing). The cursor moves to the first item in the selected part, 
or to the end marker for that part if there are no items in the part. Sample 
command: PART:1 (return). 


PLAY[:P ] 

The PLAY command is used to perform the current song (using a modified version 
of the PERFORM program). A simple low-res color display is shown during 
playback. In this display, each part has a blue horizontal line. In this line is 
a yellow dot which marks the position of middle C for that part (this dot will 
not be present when playing very high pitched notes). This middle C marker 
Slides left and right one or more octaves if necessary to show whatever pitch 
range is currently being used. Above the horizontal line, a block is shown which 
Indicates the pitch being produced. Higher pitches are to the right of the 
display. The color of this block indicates the “current loudness" of the pitch as 
follows: §-4995 black, 4996-8191 magenta, 8192-12287 dark blue, 12288-16383 
purple, 16384-2479 dark green, 29489-24575 grey, 24576-28671 medium blue, 
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286/2-32/6/ light blue, 32768-36863 brown, 36864-49959 orange, 49969-45955 grey, 
45956-49151 pink, 49152-53247 green, 53248-57343 yellow, 57344-61439 aqua, 61449- 
65535 white (loudest). (Based on Apple's suggested color names; actual colors may 
vary.) Ignoring the fact that there are two colors named grey, each color 
represents one of the 16 different actual volume settings on the MCl music card. 
Un the MC16, each color represents a range of 16 volume settings since there are 
c¢96 total volume settings available. "PLAY" plays the song using the “initial 
speed" and RATE command to select playback speed. "PLAY:P" plays the song using 
the paddle to select playback speed (allowing continuous variation). NOTE: both 
PLAY commands change (a) the CHANNEL function settings and (b) the subroutine FE 
bytes. These changes will not be apparent to the ENTRY user, but could affect 
PERFORM users. See the PERFORM section for additional information. Sample 
command: PLAY (return). 


SAVEL:<song name>[<disk specifications>]] 

The SAVE command is used to write the current song data on cassette tape (or 
whatever might be connected to the Apple's cassette Output jack) or on disk. SAVE 
Saves the song to cassette tape. SAVE:<song name>[<disk Specifications>] saves 
the song to disk. Both commands are used in the same fashion as the SAVE 
commands in BASIC. One exception: song names may contain 9% to 28 characters, 
Including any character except comma (for any character, including the first); 
control characters and trailing spaces are ignored, but leading spaces are not. 
Sample command: SAVE:GALACTIC TRIUMPH,D2 (return). 


***DTSK[:<comment> ] 

The ***DISK command increases the karma of the user when using DOS 3.1. This 
command has no effect when using DOS 3.2, DOS 3.3, or a cassette based system. 
Sample command: ***DISK: FILE NOT FOUND ERROR (return). 


TYPE 2 COMMANDS 


These commands are done immediately. They do not cause an item to be written 
at the current cursor location, as Type 3 and Type 4 Commands do, but they do 
affect the current song data. 


DEL 


The DEL symbol is used to delete the item the cursor is Currently at. It is 
requested by pressing Paddle Q's button while the upward-pointing arrow is aimed 
at DEL. When requested, the item the cursor is at is deleted from the song data. 
If it is a note, it is sounded through the music card if the Speaker/arrow block 
is lit (see the speaker/arrow Type 1 Command). The end marker of a part or 
Subroutine cannot be deleted. If this is attempted, the Apple speaker beeps. 
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DELETE:<1-255> 

The DELETE command is used to remove one or more items from the current part 
or subroutine. It is the same as one or more DEL symbol requests (above) except 
the notes are never sounded and there is no "beep" when an attempt is made to 
delete the end marker. The number of DEL'’s is selected by the <1-255> 
parameter. More than 255 items can be deleted only using more than one DELETE 
command. Sample command: DELETE:73 (return). 


EDIT 

The EDIT command is used to increase the number of parts, change the suggested 
Speed, and/or change any or all of the 4 title lines. Once entered, the command 
proceeds to ask for the new NUMBER OF PARTS?, INITIAL SPEED?, and TITLE LINE 1 
through TITLE LINE 4. If there is no change desired on any item, just press 
return. Otherwise, enter the new value and press return. For each TITLE LINE, 
the current line is displayed and can then be edited using the left and right 
arrow keys on the Apple keyboard. Note that when return is pressed for a title 
line, all characters to the right of the flashing cursor, and the character under 
the flashing cursor unless it is the 4th character, are set to space. The 
INITIAL SPEED must be a number from 1 to 255. The NUMBER OF PARTS? must be 
greater than or equal to the current number of parts, but less than 10. If the 
number of parts 1s increased, the stereo settings are set to standard settings 
(see NEW, a Type 2 Command; and STEREO, a Type 2 Command). See SUBROUTINE (a 
Type 2 Command) for details on reduction of "notes free" when increasing the 
number of parts. The cursor is set to the first item in Part %. Sample command: 
EDIT (return). 





LOAD[L:<song name>[<disk specifications> ]] 

The LOAD command is used to load a song from cassette tape (or whatever is 
connected to the Apple's cassette in jack) or disk. The song currently in memory 
is lost. These commands are used the same as the LOAD commands in BASIC. See 
SAVE (a Type 1 Command) for additional comments. The cursor is set to the first 
item in Part @. Sample command: LOAD:GALACTIC TRIUMPH (return). 


NEW 

The NEW command is used to start fresh. Once entered, the NEW command asks for 
the NUMBER OF PARTS? which should generally be entered as 1. If return is 
pressed, 1 is assumed. The number of parts cannot exceed 9. Remember that 
parts created cannot be destroyed and that song playback ends when the end of 
the highest numbered part is reached. New parts (created either with NEW or 
with EDIT, a Type 2 Command) contain KEY:C, TIME:4/4, QUARTER:249, GAP:29, 
TRANSPOSE:@, ATTACK:8192, DECAY:25, VOLUME:55090, SUSTAIN:@, and RELEASE:1599 (on ~ 
the MC16, GAP is 65535, DECAY is 59, and RELEASE is 59). (All subroutines and 

parts always end with an end marker.) Stereo is set to the standard values: 
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STEREQ:MLRMLRM*L*R* for the MC1 or STEREO:2,LRLRLR and STEREO:3,MLRMLRMLR for 
the MC16. The NEW command then asks for the INITIAL SPEED? which can be given 
as any integer from 1 to 255, or just press return for 255. Finally, the NEW 
command asks for the 4 TITLE LINES. These are initially set to all spaces. The 
cursor is set to the first item in Part ~. Sample command: NEW (return). 


SPEED:<1-65535>[_/<1-65535> | 

The SPEED command is used to change the duration of all notes, rests, and 
QUARTER functions in all parts and subroutines. The colon after SPEED is 
followed by an integer from 1 to 65535 to multiply all time durations DY. nis 
1S optionally followed by a slash (/) and another integer from 1 to 65535 
indicating a number to divide by. (If not specified, this is assumed to be 1.) 
All time durations are multiplied by the first integer, then divided by the second 
integer. Any "remainder" (or non-integral portion) is ignored, and the result MOD 
65936 is used. For example, a note length of 249 divided by 59 (using 
SPEED:1/50) would become 4 since 249/59 equals 4.8. The .8 time periods dropped 
will eventually accumulate (differently in different parts) and create unusual 
timing. Therefore, such non-integral results should usually be avoided. Any Q@ 
results are changed to 1. CAUTION: extreme care must be taken to avoid 
destruction of the song! Saving the song prior to attempting a SPEED command is 
strongly recommended. Also, see QUARTER, a Type 3 command. Sample command: 
SAVE:GALACTIC TRIUMPH (return) SPEED:1/2 (return). 


STEREO:<string> (MC1) STEREO:<2-3>,<string> (MC16) 

The STEREO command is used to change the stereo selection programmed in the 
song. The first letter in the string specifies the position for Part Q, the 
second for Part 1, etc. It must consist of L's (for Left), M's (for Middle), and R's 
(for Right). There cannot be more than 3 L's, 3 M's, Or more than 3 R's. 


Un the MCl, a star (asterisk, *) may be typed following the L, M, or R for each 
part to allow fuzz (white noise). Any part using fuzz must be identified by a 
star following its stereo letter. For example, STEREQ:ML*RM* sets parts @ and 3 
for "middle", part 1 for left, and part 2 for right; it also allows use of fuzz 
on parts 1 and 3. Only one L, M, and R can be followed by a star since fuzz can 
be used on only one channel per stereo position. 


Un the MC16, *'s cannot be used since there is no fuzz feature. Stereo is 
available only when using two or three MC16's. STEREO:2,<string> sets the stereo 
for playback with 2 cards, and STEREO:3,<string> for playback with 3 cards. On 
songs having 6 or fewer parts, both the 2 and 3 settings can be specified; on 
songs have 7 to 9 parts only the 3 setting can be used. M's (for Middle) cannot 
be used in the 2 setting since there is no "middle" card when 2 cards are used. 
Note that if timing mode will be used, there can be only two R's instead of three 
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in the 2 setting or two Ms in the 3 setting because the remaining R or M channel 
is used for timing mode. 


NOTE: the EDIT command changes the STEREO settings if the number of parts is 
increased. The stereo settings selected are programmed into the CHANNEL 
function (see the PERFORM section) and thus will be saved with the song. Sample 
command for the MCl: STEREO:MLMR (return). Sample command for the MC16: 
STEREO:3,MLMR (return). 


SUBROUT INE:<p-99> 

The SUBROUTINE command is used to create a subroutine, or to view (and thus 
ready for editing) an existing subroutine. (Note: this command may be considered 
a Type 1 Command if used to access an existing subroutine rather than create a 
new one.) The creation of a new subroutine will reduce the number of free notes 
by the following amounts depending on the number of parts: 2 for 1 part, 3 for 
2, 4 for 3 or 4, 5 for 5, 6 for 6 or 7, 7 for 8, and 8 notes for 9 parts. (NOTE: 
increasing the number of parts with EDIT, a Type 2 Command, reduces the number 
of free notes by enough to account for the difference in storage requirements 
for each subroutine (since more "notes" of storage are required per subroutine 
when more parts are present, as shown above), plus 12 and 2/3rds notes per new 
part.) The cursor is positioned to the first item in the selected subroutine, or 
the end marker in that subroutine if there are no items. CAUTION: subroutines 
are assigned numbers from Q up (by ones) when a song is loaded and when RESET 
is pressed (CQ@PG must be typed on systems without an Auto-Start ROM). The 
numerical order of the subroutines does not change. Sample command: 
SUBROUTINE:83 (return). 


TYPE 3 COMMANDS 


These commands are not done immediately, but rather are stored in the song data 
at the current cursor position. The item currently at the cursor position is 
erased unless insert mode is on. These commands do not affect playback. They 
affect only newly entered notes and rests, or the screen display. Commands of 
this type included within a subroutine affect only the display and entry of notes 
within the subroutine itself, and not within any part (or other subroutine) 
calling the subroutine. The number of notes free goes down by 1 for each 
inserted command, but stays the same for replaced commands. 





KEY:<1-6><S-F> or KEY:C 

The KEY command is used to change the key signature. (If no KEY command has 
occured in the part or subroutine so far, the key is assumed to be KEY:C.) KEY:C 
specifies no sharps or flats, and an integer from 1 to 6 followed by an S or an 
F specifies the indicated number of sharps (S) or flats (F). All notes entered so 
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as to appear in the song data after this KEY command (but before the next KEY 
command) will be affected by this KEY command. Any note not entered as "sharp", 
“flat”, or "natural" will be changed to sharp if it is one of the notes indicated 
as sharp in the key signature, or changed to flat if it is one of the notes 
indicated as flat in the key signature. Notes not indicated as either sharp or 
flat by the key signature are left as is. Sample command: KEY:3S (return). 


QUARTER:<1-65535> 

The QUARTER command is used to change the duration of notes entered except 
when using non-standard durations with LENGTH (a Type 1 Command). All notes 
entered so as to appear in the song data after this QUARTER command but before 
the next QUARTER command will be affected. (If no QUARTER command has occured 
in the part or subroutine so far, it is assumed to be QUARTER:24@. All 
Subroutines should start with a QUARTER command if the SPEED command is to be 
used.) See the PADDLE @ and PADDLE 1 Type 4 Commands for additional details. 
Sample command: QUARTER:489 (return). 


TIME:<1-19>/<note> 

The TIME command is used to change the time. signature. (If no TIME command has 
occured in the part or subroutine so far, the meter is assumed to be 4/4.) The 
colon after TIME is followed by the number of notes (of a certain duration) to 
occur per measure. This is followed by a slash (/) which does not mean division 
(this is a special case). The slash is followed by an integer which Specifies the 
note duration referenced by the other integer. It must be 1 for a whole note, 2 
for a half, 4 for a quarter, 8 for an eighth, or 16 for a sixteenth note. The 
number of time periods allowed per measure will be the current QUARTER Setting 
times 4 times the number before the slash, all divided by the number after the 
Slash. This command determines the positioning of measure bars, which in turn 
affects whether a note is sharp (or flat) or not (see the PADDLE 1 Type 4 
Command). It affects all notes entered so as to appear in the song data after 
this TIME command but before the next TIME command. sample command: TIME:2/2 
(return). 


TYPE 4 COMMANDS 


These commands are not done immediately, but rather are stored in the Song data 
at the current cursor position. The item currently at the cursor position is 
erased unless insert mode is on. These commands are executed during playback. 
They are executed during a subroutine call and thus may affect notes entered in 
a given part (or subroutine) after a call to the subroutine containing these 
commands. The number of notes remaining goes down by 1 for each inserted 
command, and stays the same for replaced commands, except as noted for TIE. 
<value> always refers to an integer from @ to 65535, optionally followed by a 
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slash (/) and another integer from 2 to 65535. When the slash is specified, the 
indicated division is done and the resultant value (ignoring any remainder or 
non-integral portion) is used as the parameter. 


REST 


The REST symbol is requested by pressing Paddle 9's button while the upward- 
pointing arrow is pointing at REST. When requested, a rest is written in the 
song data. The duration of the rest is determined in the same fashion as the 
PADDLE 1 Type 4 Command (below). 


PADDLE 1 

Note entry is accomplished by pressing Paddle l's button. The vertical position 
of the note cursor (controlled by Paddle 1's knob) determines the pitch of the 
note, subject to various sharps and flats, and (during playback only) the current 
TRANSPOSE (Type 4 Command) setting. Notes will be natural, sharp, or flat; as 
indicated by a block under one of these in the menu, and the blocks cleared, if 
one of these blocks is lit. Otherwise, notes are entered as natural unless they 
must be sharp or flat due to the current key signature or due to a prior note in 
the measure of the same pitch being sharp or flat. (Note: all octaves are 
affected by the key signature, but not by prior sharp or flat notes in the 
measure.) Natural, sharp, or flat signs are displayed on the screen only when 
necessary. Duration is as specified by LENGTH (a Type 1 Command) unless one or 
more blocks are lit under the seven notes in the menu. (Note: "." and "3" do 
affect LENGTH settings.) If a block is lit, the length will be assumed to be as 
Specified by the most recent QUARTER command for quarter notes, and 
proportional values for all other notes. A block under "." multiplies the length 
by 3/2, and a block under "3" multiplies the length by 2/3. (A block under both 
multiplies the length by 2/3 and then by 3/2.) Entry of a sixty-fourth note 
(selected by a block under the sixty-fourth note) is not allowed if the "." block 
is lit. (Dotted sixty-fourth notes are never displayed.) 


TIE 

The TIE symbol is requested by pressing Paddle Q's button while the upward- 
pointing arrow is pointing at TIE. When requested, the duration which would be 
used if a note were entered (see the PADDLE 1 Type 4 Command) is added to the 
duration of the note or rest the cursor is currently at. (If the cursor is not at 
a note or rest, the Apple speaker beeps and the cursor moves left one item.) 
This command is unaffected by insert mode, and it never changes the number of 
notes free. 





AT TACK:<value> 
The ATTACK command changes the current attack setting. The value specified is 
the maximum amount the "current loudness" can increase in any given "time 
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period". Sample command: ATTACK:55999/39 (return). 


CALL:<p-99> 

The CALL command is used to have the Type 4 Commands in the specified 
subroutine be executed during playback. The integer (from 9 to 99) specifies 
which subroutine should be done. More than one part may call the same 
subroutine (or different subroutines) at the same time. A subroutine may call 
itself provided at least one time period of duration occurs within the subroutine 
prior to the call to itself. A CALL cannot be entered until after its subroutine 
has been created. See SUBROUTINE (a Type 2 Command) for additional information. 
Sample command: CALL:83 (return). 


DECAY:<value> 

The DECAY command changes the current “decay setting’. The value specified is 
the maximum amount the "current loudness" can decrease in any given ‘time 
period" unless the RELEASE rate is currently being used. Sample command: 
DECAY:199 (return). 


FUZZ:0ON oor  FUZZ:0FF 

On the MCl, the FUZZ command is used to select fuzz (white noise) mode or normal 
mode. FUZZ mode is not available on the MC16. FUZZ:0N selects fuzz mode, and 
FUZZ:0FF selects normal mode. (NOTE: Fuzz mode must not be used in a part 
unless it has been allowed by a star in the STEREO command. See STEREO, a Type 
2 command.) In fuzz mode, pseudo white noise is produced rather than a simple 
Square wave tone. When used with high pitches and fast envelopes, percussive 
bursts can be made. Note that the “normal” mode tone will also be produced when 
FUZZ mode is on, but at a constant volume which will be whatever the "current 
loudness" was when the FUZZ:0N command was found. To avoid a tone, be sure the 
envelope has fully decayed (to zero) before using FUZZ:0N. Similarly, to avoid 
“white noise" during normal mode, be sure the envelope has fully decayed (to 
zero) before using FUZZ:0FF. Sample command: FUZZ:0N (return). 


GAP:<value> 

The GAP command changes the current gap setting. When the time remaining for 
any note equals the current gap setting, the release stage of the envelope 
begins. Sample command: GAP:69 (return). 


POKE:<$-255>,<9-255>,<f-255> 

The POKE command is used to enter non-standard commands. CAUTION: use of this 
command renders this documentation meaningless and may well scramble memory 
during playback. Integers from 39 to 175 (f-191 on the MC16) followed by Q@ and Q 
(for example, POKE:78,0,0) enter notes of zero duration; the correct duration can 
be TIEd in. For information on other values, see the PERFORM section, and the 





2-39 ENTRY Music Cards MCl & MC16 








SONG DATA FORMAT heading in this section. Sample command: POKE:144,249,9 
(return). 





RATE:<f-255> 

The RATE command changes the playback tempo. It may be included in any part, 
Dut it changes the playback tempo for all parts. (To avoid confusion, you may 
want to use RATE commands in part 9 only.) The number of time periods per 
second 1s approximately 92,773/speed. However, the RATE Setting is slightly 
different from the initial speed setting, and is computed with the formula: 
Speed-11*(number of parts). For example, in a 3 part song with an initial speed 
of 2~P, the equivalent RATE setting would be 299-11*3, or 167. Using a RATE 
commnd with a value smaller than 167 would begin a faster tempo, or a RATE 
larger than 167 would begin a slower tempo. Also see "SPEED/RATE SETTINGS" 
under "TIPS". Sample command: RATE:11 (return). 


RELEASE:<value> 
The RELEASE command changes the current release setting. The value Specified is 
the maximum amount the "current loudness" can decrease in any given "time 


period’ unless the DECAY rate is currently being used. Sample command: 
RELEASE:199 (return). 


SUSTAIN:<value> 

The SUSTAIN command changes the current "sustain setting". The value Specified 
is the “desired loudness" which the "current loudness" follows, unless the 
desired loudness is currently @ for a release stage or the current volume 
setting for an attack stage. Sample command: SUSTAIN:45909 (return). 


TEMPO:<value> 

(MC16 only.) TEMPO commands are no longer used. They can generally be replaced 
with RATE commands. The conversion formula is: RATE=TEMPO/19.17-1-11*(number 
of parts). 


TRANSPOSE:<§-255> 

The TRANSPOSE command is used to change the current transpose setting. Values 
from § to 12/7 raise all following pitches (until the next TRANSPOSE command) by 
Y to 12/7 quarter steps; values from 255 to 128 lower all following pitches by 1 
to 128 quarter steps. 24 quarter steps equals 1 octave. Sample command: 
TRANSPOSE:232 (return). 


VOLUME :<value> 

The VOLUME command changes the current volume Setting. The value specified is 
the “desired loudness" which the "current loudness" follows unless the envelope 
1S not currently in an attack stage. Sample command: VOLUME:59999 (return). 
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TIPS 


PARTIAL STARTING MEASURE 

Uften songs begin with a measure which is short, perhaps containing only a 
Single note. If such a song were entered in the normal fashion, the measure 
Dars would not appear at the correct places. There are many ways of solving 
this problem. The simplest and perhaps best way is to start by entering a rest 
which is long enough to fill one measure when the partial (starting) measure is 
entered after the rest. Not only does this put the measure bars in the right 
places, it also causes a brief delay before song playback begins during a PLAY 
command, which may be considered desirable. Another method is to put the 
partial measure in a subroutine, and call it. (The duration of notes within a 
Subroutine is not added to a part which contains a CALL to that Subroutine.) Yet 
another method is to enter the partial measure, and then enter a TIME or a 
QUARTER command to start the measure over. 


RESTS AT THE END OF PARTS 

Each part should end with a rest. It can be as short as you like, and it serves 
to begin the release stage of the envelope. Otherwise a release stage may begin 
unexpectedly (when the constantly cycling time remaining equals the current GAP 
Size). Additionally, the highest numbered part should end with a rest long enough 
to let all parts decay (or release, actually) down to zero volume, and perhaps 
even show a "blank" screen for a second. PERFORM users may find this 
particularly necessary, lest the parts continue playing after PERFORM returns to 
the calling program. 


SPEED/RATE SETTINGS 

Speed (paddle) settings which are too small will create "time periods’ which are 
not long enough for all necessary calculations. When this happens, the "time 
period" is lengthened so that all calculations are completed. Since the 
calculation time required varies, the song playback speed will vary too. There 
1s no time period variation when the speed setting is high enough. Generally, 
Speed settings lower than 159 (or equivalent RATE Settings) are never used. 
Songs having many parts active and using several levels of subroutines may 
require even higher settings. 


QUARTER and speed settings can be determined from the metronome Settings shown 
on some sheet music. Usually the metronome setting is shown with a quarter 
note, an =, and a number; that's the number of quarter notes per minute. If the 
note shown is a half note, you'll need to multiply the number given by 2 to get 
quarter notes per minute (and so on for other possible notes). Using the chart 
below, select a QUARTER setting based on the quarter notes per minute number 
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from the sheet music: 


QUARTER NOTES PER MIN. QUARTER SETTING SPEED COMMAND 


40-41 624 SPEED:13/5 
42-45 5/6 SPEEUssesoO 
46-49 5928 SPEED:11/5 
59-55 43D BrEcuse 
56-62 432 SPEED:9/5 
63-/1 384 SPEED:8/5 
12-83 336 SPEED:7/5 
84-99 283 SPEED:6/5 
1PP-125 240 

126-167 192 SPEED:4/5 
168-298 144 SPEED? 3/5 


You can either pick the QUARTER setting before you start entering your song (and 
change the QUARTER setting at the start of each part before entering notes), or 
you can enter the song with QUARTER:24@ as usual and use the SPEED command 
from the chart above to modify the song. CAUTION: be sure you have a QUARTER 
command in all subroutines, and be sure to SAVE your song before using SPEED 
(see the SPEED command) in case the results are not as desired. Now compute the 
paddle setting with the formula: SPEED=(5577465/(QUARTER*METRONOME))-1 where 
QUARTER is the QUARTER setting and METRONOME is the number of quarter notes per 
minute. This "SPEED" value can be used directly as an INITIAL SPEED or a paddle 
setting, but you must subtract 11 times the number of parts from the SPEED value 
to obtain the proper value for the RATE command. 


"BACKUP" 

While entering particularly long songs, it 1S a good idea to save the song 
periodically in case the power fails, ENTRY hits an undiscovered bug, or you 
accidently delete half the melody. 


TRANSPOSE 
Each part must contain a TRANPOSE before the first note, even if it 1s a 
TRANSPOSE:9. 


COPYING SONGS WITHOUT ENTRY 

Systems equipped with Integer BASIC can copy songs from one tape or disk to 
another without running ENTRY. Just load the song as if it really were an 
Integer BASIC program, and save it. Since it isn't a BASIC program, attempting to 
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change or delete a line, or attempting to RUN it, would probably scramble the 
song data; however, a load followed immediately by a save will work properly. 


RESET 

On systems without an Auto-Start ROM, CAPG (return) must be typed if RESET is 
pressed. That's C zero zero G, not COOG. RESET can safely be used during a PLAY 
command. RESET must not be used during the execution of any other command, or 
the song data may be destroyed. 


INTEGER/APPLESOFT SWITCH 
On systems with a ROM card (for Applesoft or Integer BASIC), the switch must be 
set for Applesoft. 


MC1 RANGE 

The lowest note on the MC1 is the C two octaves below middle C, the MC16 plays 
over an octave lower. The MCl playback routines will transpose notes which are 
too low to play up by one or more octaves. 


MC16 PARTS LIMIT 

Each MC1l6 card can play three simultaneous tones, and thus is limited to three 
parts (PART:@, PART:1, and PART:2). With two MC16's, six parts can be used; and 
with three MC16's all nine parts are available. 


SONG DATA FORMAT 


Song data is stored as described in the PERFORM section with the following 

Changes: 

I. Song data always begins in memory at 5909 hex. 

2. The END command (FF £9 ~~) is followed by a byte giving the Suggested speed, 
then 169 bytes which form the four title lines. 

3. The QUARTER command is stored with command type FB hex. 

4. The KEY command is stored with command type FC hex. A parameter of zero 
indicates C. Otherwise, the number of sharps/flats is stored with the most 
Significant bit being 9 for flat or 1 for sharp. The third byte is not used. 

5. The TIME command is stored with command type FD hex. The second byte 
indicates the number of notes per measure, and the third byte the type of 
note. 

6. All TRANSPOSE commands have a third byte of FE. This allows the least 
Significant bit of each note to indicate sharp or flat. 

7. When loaded using Integer BASIC, locations CA and CB hex ("PP") indicate the 
Starting address of the data. Locations 4C and 4D hex ("HIMEM") indicate the 
address past the last byte of data. 
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ENTRY2 


The ENTRY2 program is a new version of ENTRY designed for use on Apple Ile 
computers without paddles or on Apple III computers. (The paddles circuit of the 
Apple III is so different than the Apple II, II+, and Ile circuits that none of the 
programs in this package that require paddles will function with Apple III 
paddles.) ENTRY2 cannot be used on Apple II, Apple II+, or similar systems. 


The main difference between ENTRY2 and ENTRY is that the four arrow keys, the 
open Apple key, and the closed Apple key (or space bar on the Apple III) are used 
in place of the game paddles. 


Generally, the instructions for the ENTRY program apply to the ENTRY2 program 
as well. Where the ENTRY instructions say to turn the paddle 1 knob (or the 
"note paddle"), you should use the up arrow key or down arrow key instead. Up 
arrow and down arrow will move the "flying saucer" cursor up and down. Where 
the ENTRY instructions say to turn the paddle @ knob (or the "menu paddle"), you 
Should use the left and right arrow keys instead. Left arrow and right arrow 
will move the menu selector arrow left and right except when you are typing a 
command. (When the typing cursor is not at the leftmost column on the screen, 
left and right arrow can be used for editing in the usual fashion. When the 
typing cursor is at the leftmost position, they will move the selector arrow.) 


When the ENTRY instructions say to press the paddle 1 button (or the "note 
button") you should press the open Apple key instead. When the ENTRY 
instructions say to press the paddle @ button (or the "menu button"), press the 
closed Apple key on the Apple Ile or the space bar on the Apple III. (Note: 
remember that space bar repeats if held down.) 


References in the ENTRY instructions to use your “left hand", “right hand", or 
“same hand" should be ignored when using ENTRY2. 


Another difference is that ENTRY2 doesn't have the "PLAY:P" command, since it is 
written for use without paddles. "PLAY" can still be used, of course. 


If youre changing line 19 yourself in ENTRY2 for the MCl, you might also want 
to list line 29. It will be either 29 APPLE=2 (for use with an Apple Ile) or 29 
APPLE=3 (for use with an Apple III). This line can be changed if need be. Like 
line 19, line 2% is set automatically by the bootup program or when the 
“reconfigure programs" option is selected (in the HELLO program). 


Cassette functions should not be used with an Apple III. 
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The ENVELOPE program is used to design, hear, and view envelopes. Type RUN 
ENVELOPE to begin. (Game paddles are required. ENVELOPE cannot be used with an 
Apple III.) To help you get started, ENVELOPE has 9 pre-programmed examples (7 
for the MC16). When the program is first run, it is set up with example number 
~. To hear and see this example, set the playback speed to a relatively large 
number (over 299) with paddle ~, then press the paddle @ button. A short song 
Will be played, and the envelope (loudness contour) will be drawn on the screen 
Simultaneously, sO you can see the exact relationship between the screen and the 
sound. The screen will look like this: 


Beate ENVELOPE DESIGNER 
L 48k 
0 
fi 
_ 
D 32K 
E 
S 
S 16K 
a 
8 360 720 1989 1449 
TIME PERIODS 
ATTACK: 8192 SUSTAIN: 6 POL 210 
DECAY : SG RELEASE : SQ TRANS a 
BOLCUME: 55688 GAP 65535 


You can play example ™@ at any speed (tempo) you like just by turning the paddle 
Q knob to a different setting, then pressing the paddle @ button. The various 
envelope settings used to create the sound you hear are shown on the screen. By 
using these same settings in your song, you can create the same sound. 


To hear and see one of the other examples, type EXAMPLE: and the example 
number (@ to 8 for the MCl or @ to 6 for the MC16), then press return. After a 
long pause (during which the new example is set up), you can play the example in 
the usual manner. 


Une of the most useful features of ENVELOPE is that you can change any 
parameter and see how it affects the sound. Any of the envelope parameters 
displayed on the screen can be changed simply by typing the appropriate ENTRY 
command. For example, to change the attack rate to 1999, type ATTACK:1999 and 
press return. (These commands can be abbreviated in the same fashion as ENTRY 
commands. ATTACK:1(~% can be abbreviated to AT:199%.) The change will be shown 
on the screen, and the song fragment can be played with the new settings. 


ENVELOPE also has a variety of other commands. The DISPLAY command is used to 
change the scale of the display. By typing DISPLAY: and a number from 1 to 8, 
you can select a display 1 to 8 quarter notes wide. (Note: QUARTER is always 
assumed to be 249 time periods long.) Large settings show a long time duration 
and are useful for see the “whole picture". Small settings show a short time 
duration and are useful for seeing more detail. 
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If you prefer to type PLAY rather than press the paddle button to begin 
playback, you may. 


Several commands relate to changing the song fragment being played. The first 
is the return key. Pressing just return causes the display to change from the 
graphic display to a text display showing the notes being played. (To go back to 
the graphic display, press return.) For example @, the text display shows: 


ENVELOFE DESSiGNEr 


NOTES ARE ENTERED AS Af: 

FOLLOWED BY A LETTER FROM 

A TO G. AN_S._F->_ OR N MAY Mieka y 
THEN BE USED TO INDICATE 

SHARP, FLAT. OR NATURAL. = 4 -ASQ 
THE OCTAVE NUMBER ©CO-? 23 rns Lee 
FOLLOWS THIS. RESTS ARE 3 5 4 
ENTERED AS ‘':R'. ms baee 
BOTH FOR HOTES_AND RESTS. 6 ASO 
DURATION IS THEN _ ENTERED. ri > D2Q 

A DURATION CAN BE ANY OF S ‘> D2 

We. oH Q,. E. S. Ts. OR _* 

OPTIONALLY FOLLOWED BY 

A: a Re Ss 

ATTACK Sige SUSTAIN a) a 8 216 
DECAY 20 RELEASE 28 TRANS : a) 
lle 2 JH80H8 GAP 65535 


Song fragments are limited to a maximum of 8 notes, numbered 1 through 8. An 
arrow (-->) points to the note which can currently be changed. Two types of 
changes can be made. You can either type END to erase the note and all 
following notes, or you can simply change the note to a different note. (Note: 
the first note cannot be erased. "Note" means either a note or a rest.) To 
change a note, type : and then a note specification. A note specification is a 
letter from A to G which indicates the note within an octave; optionally followed 
by S (for a sharp note), F (for a flat note), or N (for no apparent reason); then 
a digit from @ to 7 which indicates the octave (C3 is middle C); then a duration 
specification. (Rests are specified by the letter R followed by a duration 
specification.) A duration specification is W (for whole), H (for half), Q (for 
quarter), E (for eighth), S (for sixteenth), T (for thirty-second), or X (for sixty- 
fourth); optionally followed by a period (for dotted) or a three (for triplet). (As 
in ENTRY, dotted sixth-fourth notes are not allowed.) 





For example, typing :E3Q and pressing return would change the note pointed to by 
the --> arrow to a quarter note whose pitch is the E above middle C. Typing :RS3 
and pressing return would change the pointed note to a sixteenth triplet rest. 
When a note is changed, the pointer advances to the next note so it can be 
changed if desired. (Note: when the 8th note is entered, the pointer remains at 
note 8 since no additional notes can be entered.) 


To move the --> pointer to any desired position, type EDIT: and the position 
number. For example, EDIT:1 moves the pointer to the first note. 





When you are finished using ENVELOPE, type FP to exit the program. 
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COMMANDS 


*R<duration> or ><note><duration> 
AT TACK:<value> 

DECAY :<value> 

DISPLAY:<1-8> 

EDIT:<1-8> 

END 

EXAMPLE:<$-8> (MC1) EXAMPLE:<@-6> (MC16) 
FP 

FUZZ:0ON or  FUZZ:OFF (MC1 only) 
GAP:<value> 

INT 

PLAY 

RELEASE:<value> 

SUSTAIN:<value> 

TRANSPOSE:<-255> 

VOLUME :<value> 


<duration> is a duration letter (W, H, Q, E, S, T, or X); or a duration letter 
followed by a period, or a duration letter followed by a 3. <note> is a note 
letter (A, B, C, D, E, F, or G) followed by an octave digit (P, 1, 2, 3, 4, 5, 6, or 
/), Or a note letter followed by an accidental letter (S, F, or N) followed by an 
octave digit. <value> is an integer from 9 to 65535 optionally followed by a 
Slash (/) and an integer from 1 to 65535 (see the ENTRY section). 


LINE 10 


Line 1 contains the variables SLOT, UNITS, and CARD. These are set by the 
HELLO program automatically. If you wish to change this line yourself, LOAD 
ENVELOPE, list and change line 19, then SAVE ENVELOPE. If you have an MCl, use 
UNITS=1 and CARD=1. If you have an MC16, use the appropriate UNITS setting and 
CARD=16. 














A 





PROCESS/MLIST 
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PROCESS 


The PROCESS program is used to do advanced editing of ENTRY-created songs. 
Mainly, PROCESS allows you to move large sections of music in order to change 
parts into subroutines, or work on a musical section as an independent song and 
then append it onto the main song. You begin using PROCESS by typing RUN 
PROCESS. 


An important feature of PROCESS is that it works with two songs in memory at 
once. Une song is called the main song. All editing actually takes place on the 
main song. Ihe second song is called the auxiliary song, which is only used in 
certain applications. Sections can be read from the auxiliary song and appended 
to the main song. It 1S important to note that the main song and the auxiliary 
song can actually be the same song. This is done when you wish to read a 
section from one place in a song and append it to another place. 


Generally you start with a LOAD command. Typing LOAD: and a song name (then 
pressing return, as usual) causes the specified song to be read from disk and 
used as the main song. (Note: if you already had a main song or a main song and 
an auxiliary song, it or they will be lost.) You may then use the various editing 
commands or the status printing commands. If you make any changes in the song, 
you must use the save command if you wish to have a copy of the song with 
these changes saved on disk. This is done by typing SAVE: and a song name. You 
don't have to save the song with the same name. in fact, it is usually best to 
Save the song with a different name if you have enough space on your disk; that 
way youll have a copy of the song before any changes (with the original name 
used in the LOAD command) and a copy with the changes (with the new name used 
in the SAVE command). Then if you later discover you didn't make the changes 
you intended to make, you can get the original back and do whatever you wish. 





Only the APPEND command requires an auxiliary song. The following commands 
require only the main song. 


The DELETE command is used to delete a part or a subroutine. You just type 
DELETE:PART and the part number, or DELETE:SUB and the subroutine number, then 
press return. For example, you type DELETE:SUB 5 to delete subroutine 5. 
(Remember that subroutine numbers always start with @ and go up by l's. In 
ENTRY you can assign any numbers you like to subroutines, but when you save the 
song they are automatically changed to start with @ and not skip any numbers.) 
It 1s very important to remember that from the time you LOAD the main song to 
the time you SAVE it, all part and subroutine numbers will stay the same. For 
example, if you delete subroutine 3, subroutines 4 throught 7 (or however many 
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Subroutines you have) do not suddenly become subroutines 3 through 6. 
Subroutine 4 will remain subroutine 4 throughout the session. When you SAVE the 
Song, subroutines 4 through 7 would become 3 through 6 unless you've "filled in" 
the missing subroutine 3 with an APPEND command. The various calls to 
Subroutines 4 through 7 will be changed so they still call the proper 
Subroutines, of course. Likewise, if you delete part 2, parts 3 on will remain 3 
on until the SAVE; at which time they will be renumbered so there are no missing 
numbers. 





If you attempt to delete a subroutine that is called by some remaining part or 
Subroutine, the warning “THIS WILL CREATE UNDEFINED REFERENCES" is printed, and 
you will be given a Chance to change your mind. 


CAUTION: if you delete a part, the stereo settings will be reset to standard 
settings. 


The CHANGE command is used to change all CALL's in a specified song subset so 
they call a different subroutine. For example, to change all CALL:2's in all parts 
and subroutines into CALL:5's, you type CHANGE:2 TO 5. If you wish to change only 
the CALL's which occur in parts (and not those in subroutines), add IN ALL PARTS 
to the command. To change only the CALL's in a particular part, add IN PARTand 
the part number. Similarly, CALL's in a subroutine can be changed by adding IN 
SUB and the number. For example, to change all CALL:4's in subroutine 3 to 
CALL:/7's, type CHANGE:4 TO 7 IN SUB 3. (Or, if you don't like to type, you can 
abbreviate that command to just C:4T71IS3.) If you change the CALL's to a 
Subroutine number that doesn't exist, you will get the "THIS WILL CREATE 
UNDEFINED REFERENCES" message and a chance to change your mind. 





The STATUS command prints the value of various parameters at the end of the 
selected part or subroutine. You type STATUS:ALL PARTS, or STATUS:PART and a 
part number, or STATUS:SUB and a subroutine number. For example, when you type 
STATUS:PART 2 the status command will look through all commands in part 2, 
remembering the most recent setting for each parameter and compiling similar 
information. The last setting for KEY, TIME, QUARTER, GAP, TRANSPOSE, ATTACK, 
DECAY, VOLUME, SUSTAIN, RELEASE, FUZZ, TEMPO, and the various possible POKE's will 
be printed. Then a list of all subroutines called, and the total time duration in 
time periods will be printed. Note that if any parameter doesn't occur at all in 
the subset scanned, it will not be printed. An example use for this command 
would be if you've entered half of a song, and wish to put the other half in a 
Separate song for now so you don't have to play through the first half (which 
you've already perfected) to hear the second half (which you're working on). 
First, you do a STATUS:ALL to get a list of final parameters for each part. If 
you have a printer, you can use PR# to output the list to your printer. 
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Otherwise, write them down. Now, run ENTRY and create a song. Change all the 
parameters at the beginning of each part so they match the final parameters 
printed by the STATUS command. Now you can enter the second half of the song, 
and the various parameters (such as the envelope parameters and the transpose 
settings) will match whatever you left off with in the first half. When you've 
got the second half finished, delete any parameters at the beginning of each 
part that you haven't changed (in other words, that still match the final states 
from the STATUS command of the first half), save the song, and use PROCESS to 
append it to the first half. 


Note that when the status command scans a part or subroutine, it does follow all 
Subroutine calls to see what parameter changes might be present and to include 
the subroutine in the total time periods count. If subroutines are used to make 
the playback infinite for the part or subroutine being scanned, the final state 
list will not be printed, but the “subroutines used" list will be. (The total time 
periods will be listed as infinite.) 


The WIDTH command is used to change the terminal width for a printer. You type 
WIDTH: and the width in printing columns. CAUTION: Apple's built-in ROM I/0 
routines function improperly with widths greater than 49; memory may be erased 
if the width is set greater than 49 while the printer is PR#@. If the printer 
width is greater than 49, always (1) set output to the printer using the PR# 
command, then (2) change the printing width with the WIDTH command. To go back 
to the Apple screen, always (3) change the printing width to 49 by typing 
WIDTH:49 and pressing return, then (4) set the printer to the screen by typing 
PR#9 and pressing return. 


PR# 1S not a PROCESS command, it is an Apple DOS command. The following DOS 
commands may be used from PROCESS: CATALOG, DELETE, FP, IN#, INT, LOCK, PR#, 
RENAME, and UNLOCK. Since Apple DOS commands use keyword separators at random 
(rather than consistently using a specific separator such as :), they cannot be 
abbreviated. PROCESS's use of : aS a separator after all commands allows it to 
have a simple abbreviation routine. This routine lets you shorten your commands, 
if you wish, to the smallest number of letters needed to tell it apart from any 
other command. Or, you can add more letters if you like and abbreviate the word 
only slightly. Since PROCESS checks to see that all letters you do give are 
correct, there 1s no problem with a typing error like SATUS being taken as SAVE 
just because it starts with SA. If you type STAT you can be confident you're 
going to get "status". If you just type S, PROCESS will print AMBIGUOUS COMMAND 
So youll know there are two or more commands which start with S, and you 
Should add another letter or two. Some day, all quality software will 
incorporate similar human engineering. On the other hand, maybe all quality 
software already does. 
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The AUXILIARY command is used to load an auxiliary song from which parts and/or 
Subroutines will be read to append to the main song. You type AUXILIARY: and the 
Song name. You can load the same song you loaded as the main song if you wish. 
When the auxiliary song is loaded you can select various options. Typing 1 and 
pressing return gives you option 1 which just loads the auxiliary song. 


Typing 2 and pressing return gives you option 2 which moves any "extra" 
Subroutines from the auxiliary song to the main song. For example, if the main 
song has 3 subroutines (9-2) and the auxiliary song has 7 subroutines (f-6), 
Subroutines 3 through 6 from the auxiliary song will be moved to the main song. 
Subroutines % though 2 in the auxiliary song remain in the auxiliary song. This 
is useful if you are adding the second half of a song (the auxiliary song) to the 
first half of a song (the main song) and you needed subroutines from the first 
half when entering the second half. (Perhaps the second half plays melodies 
which are already in subroutines in the first half.) Since you may have deleted 
all the notes in some unused subroutine to gain space for the second half, 
subroutines §-2 in the main song must stay as is. The new subroutines you've 
added for the second half (3-6 in this case) must be moved to the main song 
Since they'll be needed. To finish the transfer, you'll need to append each part 
in the auxiliary song to the matching part in the main song. 





If there are no subroutines in the main song, only options 1 and 2 will be 
available. If there are subroutines, you can also type 3 and press return for 
option 3. Option 3 will renumber all the subroutines in the auxiliary song and 
move them to the main song. For example, if the main song has 3 subroutines (Q- 
2) and the auxiliary song has 7 (9-6), subroutines 9-6 in the auxiliary song will 
be renumbered as 3-9 and moved to the main song. All calls in the auxiliary 
song will be renumbered too so they will still reference the proper subroutine. 
No subroutines will remain in the auxiliary song. This option is useful if you're 
adding the second half of a song (the auxiliary song) to the first half (the main 
Song) and you didn't need any of the subroutines from the first half when 
entering the second half. Therefore, you'll want all your new subroutines 
shifted so they don't conflict with the first half's subroutines, and moved to the 
main song. Then you just append each part from the auxiliary song to the same 
part in the main song, and you've added the two halves together. 


The APPEND command is used to move a part or subroutine from the auxiliary 
song (you must have already loaded one with the AUXILIARY command) to the end of 
a part or subroutine in the main song. You type APPEND: then a reference, then 
TQ and then another reference. A "reference" is either PART and a part number, 
or SUB and a subroutine number. For example, to append part 3 from the 
auxiliary song to the end of part 2 in the main song, type APPEND:PART 3 TO PART 
¢ and press return. Since the APPEND command moves the specified part or 
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Subroutine, once you move a given part or subroutine from the auxiliary song, 
it's no longer available to move again. 


If the part or subroutine you try to append onto doesn't exist (in the main song), 
it will be created. Note that when a part is created, the usual parameters 
(KEY:C, TIME:4/4, and the various * items) that ENTRY would put in a new part are 
not created. This avoids the duplication that would occur when a part is moved 
into a new part. You must remember, however, to add all necessary parameters if 
you move a subroutine (which might not have them) to a new part. 


CAUTION: if APPEND creates a new part, the stereo settings will be reset to 
Standard settings. 


One common use of APPEND is to change a part into a subroutine. For example, if 
you wish to change part 5 into a subroutine and your song already has 3 
Subroutines (f-2), you'll want to change part 5 into subroutine 3. To do this, you 
Save your song (let's say you type SAVE:GALACTIC TRIUMPH while running ENTRY, 
then use FP to exit ENTRY). Type RUN PROCESS, and LOAD:GALACTIC TRIUMPH. Type 
AUXILIARY:GALACTIC TRIUMPH. Since your 3 subroutines are already present in the 
main song, you won't want to duplicate them by asking for option 3; so use option 
1 to not move any subroutines (or, option 2 would do the same thing). Now type 
APPEND:PART 5 TQ SUB 3 to change part 5 into subroutine 3. A subroutine 3 will 
be created in the main song (since there wasn't one before), and part 5 from the 
auxiliary song (which is also your GALACTIC TRIUMPH song) will be moved into the 
new subroutine. If you want to get rid of part 5 (since it's now also in 
Subroutine 3), type DELETE:PART 5. If you want to keep both part 5 and 
Subroutine 3, don't delete part 5. Now, type SAVE:NEW GALACTIC TRIUMPH, then type 
FP to exit PROCESS. Presto! Part 5 is now subroutine 3. If you discover you 
really meant to change part 4 into subroutine 3, then go back to PROCESS and 
Start with LOAD:GALACTIC TRIUMPH again. Or, you could take NEW GALACTIC TRIUMPH 
and turn subroutine 3 into part 5, delete subroutine 3, append part 4 into 
Subroutine 3, and delete part 4. 





As just described, the SAVE command is used to save the main song after you've 
made the changes you want. Note that when you save a song, empty subroutines 
must be created for any subroutines that have been deleted but are still called. 
You will be given a chance to continue processing rather than save if this is 
the case. When you save a song, the main and auxiliary songs are cleared, and 
if you wish to continue processing the song you must load it again. Note that a 
Song with zero parts cannot be saved. 





The FP command is used to exit PROCESS. 
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Two additional commands are available for use by skilled programmers. (If 
you're a mere mortal, you won't need these commands.) They are BLOAD and BSAVE. 
BSAVE is the same as SAVE except it causes the main song to be saved as an 
Apple DOS "B" file in a special format. There are three formats available for 
songs. First, there's the "M:" format used by ENTRY and PLAY, where the song 
appears in the catalog as if it were an Integer BASIC program. This format 
allows the song to be readily copied from one disk to another, using Integer 
BASIC's LOAD and SAVE commands. The second format is the B format shown in the 
PERFORM section of this manual. It is the same as the "M:" format except the 
song appears in the catalog as a Binary file. The third format is the "B:" 
format available though the BSAVE command in PROCESS. It also appears in the 
catalog as a Binary file, but you can tell the three formats apart by their 
names. For example, GALACTIC TRIUMPH appears as M:GALACTIC TRIUMPH in the M: 
format, as GALACTIC TRIUMPH in the B format, and as B:GALACTIC TRIUMPH in the B: 
format. 


The B: format is very similar to the B format. The only differences are: (1) 
there are always 18 bytes (9 pointers) after the part count byte (the first byte 
of the song data) even though the last pointers may not be used, (2) there are 
always 3 FE bytes before a subroutine, and (3) the relative addresses in CALL's 
are replaced by the subroutine number (9-99) in the third byte of the command. 
The B: format allows you to write your own programs which load the song and 
make various changes, then save the song again. The B: format song can then be 
loaded using the BLOAD command in PROCESS, and saved in the M: format using the 
SAVE command. The BLOAD command ignores the 18 bytes after the part count 
byte, and computes them by looking for the CHANNEL commands at the start of 
each part. Thus, you don't have to update the part pointers if you don't wish to. 
Qne thing you might forget is that the initial speed byte must be located by 
looking 16% bytes down from the end of the data, and not by just assuming the 
initial speed byte will be the first byte after the END command. (In other words, 
we might stick something between the END command and the initial speed byte 
while you're not looking.) 


RATE 


PROCESS was written before the RATE command was added to ENTRY. Thus, the 
RATE command will show as POKE 295,1,n (in the STATUS command, for example). 
Also, the "ALTERNATE SPEED" parameter is not used with this new version of 
ENTRY. 
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COMMANDS 


APPEND:<part or sub> TO <part or sub> 
AUXILIARY:<song> 

BLOAD:<song> 

BSAVE:<song> 

CATALOG 

CHANGE:<$-99> TO <f-99> LIN <subset>] 
DELETE 

DELETE:<part or sub> 

FP 

IN# 

INT 

LOAD:<song> 

LOCK 

PR# 

RENAME 

SAVE :<song> 

STATUS 

STATUS:<subset> 

UNLOCK 

WIDTH:<1-255> 


¢<song> 1S a song name optionally followed by S<slot> and D<drive number> 
specifications (see your Apple DOS manual for S#D# details). <part or sub> is 
PART<9-38> or SUB<9-99>. <subset> is ALL PARTS or PART<-8> or SUB<Q-99>. 


LINE 10 


If you wish to change line 19, LOAD PROCESS, list line 19, change only the 
appropriate numbers, then SAVE PROCESS. Note that CARD=1 is for the MCl, and 
CARD=16 is for the MC16. Normally line 19 is set correctly by the “reconfigure 
programs option in the HELLO program menu. 
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MLIST 


The MLIST program is used to list a song in alphanumeric form on the screen, on 
a printer, or to a text file. To use the program, begin with RUN MLIST. 





The LOAD command is used to select a song for listing and read it from the 
disk. You type LOAD: then the song name, and press return. (Note: do not type 
the "M:" part of the name. To load a song which appears as M:SOLFEGGIO in the 
catalog, type LOAD:SOLFEGGIO.) Once loaded, the song can be listed as many times 
as you like. If you wish to begin listing a different song, another LOAD command 
can be used to load in the next song. 


The LIST command is used to list a song. To list all parts and all subroutines, 
just type LIST and press return. To list only the parts, type LIST:ALL PARTS 
(note: this can be abbreviate to LI:A if you prefer). To list a particular part, 
type LIST:PART and the part number. For example, LIST:PART 3 will list only part 
3. Similarly, to list a particular subroutine, type LIST:SUB and the subroutine 
number, for example LIST:SUB 3. (These could be abbreviated to LI:P3 or LI:S3.) 


You can also restrict the listing to a particular range of "command numbers". 
(Command numbers are explained in the PERFORM section, and in the SONG DATA 
FORMAT part of the ENTRY section.) All notes have command numbers from 9 to 
191, and all rests have a command number of 192. All other commands have 
numbers from 193 to 255. Thus, if you restrict the listing to values from @ to 
192, you'll get only the notes and rests. If you restrict it to values from 193 
to 255, you'll get everything else. The CALL command has a command number of 
201, so if you wish to list only the subroutine calls you would restrict the 
listing to command number 291. This would be done by typing LIST:2@1. You could 
type LIST:291,192 to list both CALL commands and rests, for some unfathomable 
purpose. To list commands within a range of numbers, you use a dash (-). For 
example, LIST:$-191 would list all notes. If the starting number is to be Q, or 
if the ending number is to be 255, the number can be omitted. LIST:@-191 is the 
Same as LIST:-191. To list everything except notes and rests, type either 
LIST:193- or LIST:193-255. You can also specify several ranges. LIST:-191,193- 
would list everything except rests. Or, LIST:-191,193-299,292- would list 
everything except rests and subroutine calls. 





When using a restricted range, you can also add the word IN and use the ALL 
PARTS, PART <-8>, or SUB <Q-99> options described above. For example, LIST:291 
IN PART 2 will list only subroutine calls in part 2. (This could also be 
abbreviated LI:2911P2.) 
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Any list command can be followed by a star (*) if you wish to have an 
abbreviated listing. ATTACK:8192 prints as AT:8192 in an abbreviated listing. A 
Sample command would be LIST:2@1 IN PART 2%. Note that when using just LIST, 
you must type LIST:* (not LIST*). 


The PR# command is used to print the listing on an Apple "“PR#"-compatible 
printer. For example, PR#1 will cause the output of all list commands to be sent 
to the printer plugged into slot 1. (All other output will continue to go to your 
present console.) If you wish to resume listing to the Apple screen, type PR#Q. 
Since the PR# command is an Apple DOS command, it cannot be abbreviated. 


To print the listing to an Apple text file, type PR# and the name of the file. 
For example, PR#SAMPLE will cause the output of all list commands to be written 
into a text file named SAMPLE. (Disk specifications such as PR#SAMPLE,D2 can be 
added if desired.) The output of as many list commands as you like can be 
written into the file. When you no longer wish to output lists to file, type PR#9 
to go back to the Apple screen, or type FP to exit MLIST. 


The WIDTH command is used to adjust the width of your listing. The normal width 
is 49 characters, to match the Apple screen. CAUTION: Apple's built-in ROM I/0 
routines function improperly with widths greater than 49, memory may be erased 
if a LIST command is used while PR# is @ and the width is greater than 49. 
Therefore, when selecting a larger width for a printer, always (1) set the 
printer slot using PR#, then (2) set the larger width using WIDTH:, then (3) make 
your listings. If you wish to list to the Apple screen now, first (4) set the 
width back to 49, then (5) select the screen with PR#Q. 


The FWIDTH command is used for the same function as the WIDTH command, except 
it applies only to the output of LIST commands going to a text file. FWIDTH is 
normally 49, but you may wish to make it larger to avoid breaking a long line 
into several strings. 


The FP command is used to exit MLIST. It cannot be abbreviated. 


Also, certain Apple DOS commands can be used from MLIST. They are: CATALOG, 
DELETE, FP, IN#, INT, LOCK, PR#, RENAME, and UNLOCK. Since Apple DOS commands 
use keyword separators at random (rather than consistantly using a specific 
separator such as :), they cannot be abbreviated. 


Control-S can be used during a listing to temporarily suspend output. Pressing 
almost any key (except control-C or RESET) will resume the output. Control-C can 
be used to quit listing. 
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Notes and rests in the listing are preceded by a colon (:). The format of a note 
Specification is described in the ENVELOPE section. The only difference is that 
a tied note or rest is printed in the same format as a rest, but with a T (for 
tied) instead of an R (for rest). Thus a note which displays in ENTRY as a D 
above middle C quarter note tied to a sixteenth note will be printed as :D3Q; :TS. 
Similarly, a quarter rest tied to a sixteenth rest prints as :RQ; TS. Non-standard 
durations are printed numerically. 


Note that the S, F, and N specifications will match the graphics display of ENTRY 
rather than ENTRY's text display. That is, a note which is sharp due to a sharp 
in the key signature or a Sharp note earlier in the measure will not be marked 
with an S. This also applies to flat notes and F. 


Measure bars are not printed. Each measure begins a new line which starts with 
the measure number. When doing a restricted listing, measures with nothing to 
print are not printed. 


SAMPLE LISTING 


A sample listing of the beginning of "America" is shown below. 








JRUN MLIST 
-LOAD:AMERICA 
-LIST 

PART :9 


1 KEY:1S; TIME:3/4; QUARTER: 249 
GAP:20; TRANSPOSE:9; ATTACK:8192 
DECAY:25; VOLUME:55999; SUSTAIN:9@ 
RELEASE:1590; :G3Q; :G3Q; :A4Q 


2 :F3Q.3; :G3E3; :A4Q 
3 :B4Q; :B4Q; :C4Q 
4 :B4Q.3; :A4E; :G3Q 
5 :A4Q; :G3Q; :F3Q 
O <G3h. 
PART :1 


1 KEY:1S; TIME:3/4; QUARTER:249 
GAP:20; TRANSPOSE:@; ATTACK:8192 
DECAY:25; VOLUME:55990; SUSTAIN:@ 
RELEASE:1599; :D3Q; :D3Q; :E3Q 

C. 20508: SE3E5 FFS0 
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°GSU0; S650; =G30 
$G50.- tProe. <eoU 
feo. 030" 2050 
Sits 


DN Om H&S W 


PART :2 


1 KEY:1S; TIME:3/4; QUARTER:249 
GAP:20; TRANSPOSE:@; ATTACK:8192 
DECAY:25; VOLUME:55999; SUSTAIN:9 
RELEASE? 1T5O00: #620: <E20* =C20 


2 =)207 2020: s0zZ0 
> 26202 2EcU; $020 
a $0205 20570. 2620 
* @G6ceu, S020. =pz0 
O 2G2is 

-LIST:193-* 

PART : 


1 K:1S; T1:3/4; Q:249; GA:20; TR:@ 
ATsel192: DEG2 252 Ve55000- SUS..0 
R: 1500 





PART: 1 


1 K:1S8; T1:3/4; Q:240; GA:29; TR:Q 
AT:8192; DEC:25; V:55090; SUS: 
R: 15) 


PART :2 
L KtisS: [12374- 02240. GA:20: TRO 


AT:8192; DEC:25; V:55090; SUS: 
R: 1500 


The second listing shows an abbreviated (*) listing of everything except notes 
and rests. 
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COMMANDS 


CATALOG 

DELELE 

FP 

FWIDTH:<1-255> 

IN# 

INT 

LIST) <* | 

LIST:L<numbers> IN]<subset>[*] 
LIST:<numbers>|[ *] 

LOAD:<song> 

LOCK 

PR# 

PR#<file name> (cannot be abbreviated) 
RENAME 

UNLOCK 

WIDTH:<1-255> 


<numbers> is a number range, or several ranges separated by commas. A number 
range 1S a number, or a dash and a number, or a number and a dash, or a number 
and a dash and another number. A number is an integer from @ to 255. <subset> 
1s ALL PARTS or PART<-8> or SUB<$-99>. <song> is a song name optionally 
followed by S<slot> and D<drive number> specifications (see your Apple DOS 
manual for S#D# details). 


RATE 


MLIST was written before the RATE command was added to ENTRY. Thus, the RATE 
command will list as POKE 295,1,n (where "n" is the selected rate). 
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PLAY 


The PLAY program is used to play songs entered with ENTRY. Although songs 
Cannot be edited with PLAY, it has several advantages over ENTRY. PLAY's main 
advantage is that it requires less memory than ENTRY. This means that PLAY can 
be loaded faster than ENTRY, and it allows playback of songs which are too large 
to load with ENTRY. Another important feature of PLAY 1S that most disk 
commands can be used (ENTRY allows only LOAD and SAVE). This allows "Exec 
Files’ to be used, either as created by the DISCO or HUSTLE programs or custom 
files. | 


Normally, PLAY will be set for the correct slot by the boot-up configuration 
program. However, if you wish to change line 19 yourself, LOAD PLAY, LIST 19, 
and carefully retype the line changing only the slot/units digit(s). Now type 
SAVE PLAY. 


When run, PLAY will print a period (.) as a prompt character. The following 
commands can then be used: 


LOADL:<song name>[<disk specifications> ]] 
This command is the same as the load command in ENTRY (see the ENTRY section, 
SUMMARY OF COMMANDS). 





PLAYL:<song name>[<disk specifications> ]] 

This command is a mixture of the play command in ENTRY (see the ENTRY section, 
SUMMARY OF COMMANDS) and the load command (above). Typing PLAY (return) is used 
to play the song currently in memory (you must have already loaded a song, of 
course). PLAY:<song name>[<disk specifications>] is used to load a song and then 
play it. 


STOP 

This command is used only in ALBUM files created by DISCO (see the DISCO 
section). It goes to BASIC, leaving the PLAY program in memory for continuation 
with RUN. Either RUN or FP should always be used after a STOP command. 


FP 
FP 1S used to stop using PLAY. The PLAY program is erased and must be reloaded 
if you desire to run it again. 


RESET may be pressed to stop song playback. When the ] prompt appears, type 
RUN. Do not use RESET while loading a song, and never use control-C. 
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ALBUM FILES 


The DISCO and HUSTLE programs are used to create “album files". An album file 
is a text file containing the names of songs to be played. Album files can be 
used in two ways: to play several songs in a predetermined order, or to play 
several songs in a random order. When using a random playback order, a 
particular song can be designated as the song to always play first, and likewise 
another song can always be played last. 


Album files can be created with either the DISCO program or the HUSTLE program. 
Once created, all songs can be played in the predetermined order by typing EXEC 
ALBUM. The songs can be played in random order by typing RUN DISCO. Note that 
the album files contain only the names of the songs to be played (in a special 
format as required by the PLAY program) and not the actual songs themselves. 
The songs, and the PLAY program, must be stored on the disk the album file is 
Stored on. 


DISCO 


The DISCO program is used mainly to change the order of the names in the album 
file so playback order will be random. The disk containing the album file (and 
the DISCO and PLAY programs, and songs) must not be write-protected. (When using 
EXEC ALBUM for non-random playback, the disk can be write-protected.) The 
random order playback function is requested simply by typing RUN DISCO (an album 
file must already exist). 





DISCO can also be used to create an album file. If an album file already exits, 
begin by typing DELETE ALBUM. Then type LOAD DISCO and RUN 1999. DISCO will 
print a brief set of instructions. You simply type in the name of each song to 
be played. If you won't be using randomized playback order, type the names in 
the order you wish them to be played. You can type CATALOG if you wish to see 
the catalog. If you wish to have a song which will always be played first (when 
using randomized order), the first song name you type must be START. If you 
wish to have a song which will always be played last, it must be entered last 
and be named END. If you do not wish to have an "END" song, type STOP when you 
are finished entering names. 


If the songs to be played are on two disks, all song names must be followed with 
1 or ,D2 (whichever is appropriate). If your system has more than two drives, 
you can create album files which use songs on several drives. In this case, all 
song names must be followed with the slot and drive numbers (e.g. ,S6,D1). 





To add song names to an album file, type LOAD DISCO and RUN 2999. Songs are 
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added in the same fashion as just described. If an END song was previously 
entered, it will remain at the end of the album file. If a START song is added, 
it may not be played first since it may not be the first song listed. 


HUSTLE 


The HUSTLE program is used to create an album file containing the names of all 
songs on the disk, or to delete particular song names from an existing album 
file. 


Note that although the HUSTLE program has a line 19 which reads 19 CARD=1 
(which indicates the program is configured for an MCl), this line never needs to 
be changed. Even when using an MC16 (which would imply a CARD=16 setting), this 
line should be set with CARD=1 because the older MC16-format album file is no 
longer used. 


If you wish to create a new album file and an old album file already exists on 
the disk, begin by typing DELETE ALBUM. Then type RUN HUSTLE. If you wish to 
add or delete songs from an existing album file, just type RUN HUSTLE. 


Instructions for using HUSTLE are presented as the HUSTLE program runs. Note 
that you should stop the HUSTLE program only by using the exit option. Otherwise 
a temporary file, named- ALBUMX, may be left on your disk. 





When creating an album file using two or more disks of songs, drive 
specifications will automatically be included in the album file (e.g. ,D1l and ,D2). 
Therefore, the disks must be placed in the same drives during playback as they 
were in during album file creation. 


PLAYING THE ALBUM 


To play the whole sequence of songs after creating your album file (or with an 
album file supplied on your MC1/MC16 software disk or song disk), just type EXEC 
ALBUM. Or, for randomized playback order, type RUN DISCO (your disk must not be 
write-protected to use DISCO). A properly configured PLAY program must be on 
the disk the album file is on. When album playback is complete, you can type RUN 
to continue using the PLAY program (do not type RUN PLAY), otherwise type FP. If 
you wish to hear the songs again, type FP and then EXEC ALBUM (or RUN DISCO). 
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The CHROMA subroutine is used to write your own programs which use the MC16 to 
produce chromatic (equal tempered) pitches. (CHROMA is not supplied with the 
MC1.) The various routines in CHROMA are: 


1. INITIALIZER. Written in BASIC, this routine initializes the music card, the 
CHROMA routine, and the PULSE routine. 

2. PARTIAL INITIALIZER. Written in BASIC, this routine is used to initialize 
additional music cards. 

3. CHROMA. Written in 6592 assembly language, this routine is used to program 
‘normal mode" (square wave) pitches. 

4. PULSE. Written in 6592 assembly language, this routine is used to program 
“nulse mode" (pulse wave) pitches. 


The parameters required by these routines, their calling procedures, functions, 
and results are described below. 


INITIALIZER 


The INITIALIZER uses the value of the variable SLOT. Prior to calling the 
INITIALIZER, this variable should be set to the expansion slot number one of your 
music cards is plugged into. The INITIALIZER is called using GOSUB 32767. It 
will initialize the music card, correct memory addresses in the CHROMA and PULSE 
routines, assign values to the variables PITCH and VOLP, and poke SLOT*16 at 
PITCH+2 and @ at PITCH+3 (see table below). "Initialize the music card" means to 
set all three channels to zero volume and “normal mode”. 








POKE ADDRESS NAME DESCRIPTION 








PITCH PITCH Pitch number 

PITCH+1 PART Channel (part) number 
PITCH+2 Slot number times 16 
PITCH+3 OFFSET Pitch offset 

PITCH+4 WIDTH Pulse width 

PITCH+5 Divisor low 

PITCH+6 Divisor high 

PITCH+/ CHROMA CHROMA entry point 
(PITCH+8 and PITCH+9 are reserved.) 
PITCH+19 PULSE PULSE entry point 
(PITCH+11 and PITCH+12 are reserved.) 
PITCH+13 (start of divisor table) 


The table above shows the memory locations used for parameter storage by the 
CHROMA and PULSE routines. The address of this table is indicated by the value ~ 
assigned to PITCH, which is based on the value of HIMEM (or the length of your 
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program when using Applesoft). Note that when using Integer BASIC, HIMEM must 
not be -32498, -32433, or any value in between. 


The variable VOL@ is used to set volume levels and change modes. 
POKE ADDRESS NAME DESCRIPTION 


VOLQ VOL@ Volume for channel 
VOLO+1 VOLI Volume for channel 1 
VOL9+2 VOL2 Volume for channel 2 
VOL9+3 Mode control A 
VOLP+/7 Mode control B 


Values poked at the above addresses go directly to the music card and cause the 
volume or mode to change immediately. Values from @ to 255 can be poked for 
volume (f=off or l=soft to 255=loud). The following values can be poked for 
mode control (other values should not be used). 

POKE ADDRESS VALUE FUNCTION 





VOL9+3 iy Both channels @ and 1 to pulse mode 

VOL9+3 ] Channel § to normal mode, channel 1 to pulse mode 
VOL9+3 2 Channel @ to pulse mode, channel 1 to normal mode 
VOL9+3 3 Both channels @ and 1 to normal mode 

VOLQ+/7 50 Channel Q to pulse mode 

VOLQ+7 54 Channel @ to normal mode 

VOLQ+7 114 Channel 1 to pulse mode 

VOLQ+7 118 Channel 1 to normal mode 

VOLQ+7 182 Channel 2 to normal mode (used by the INITIALIZER) 


The INITIALIZER and PARTIAL INITIALIZER set all three channels to normal mode. 
To change modes, set the mode by poking the value shown above to VOL9+7, then 
the appropriate value (above) to VOL@+3. 


The value assigned to VOLM by the INITIALIZER or PARTIAL INITIALIZER is 
different for each expansion slot and is calculated by the formula VOL@=SLOT *16- 
16256. 


The mnemonic variable names shown in the first table can be set using the 

following statements. (Note: the variable name PART was given as CHANNEL, which 

1S more appropriate, in previous manuals. However, Applesoft does not allow two 

variables to be named CHANNEL and CHROMA.) The setup and calling of the 

INITIALIZER is included: 

12 SLOT=4 (replace 4 with the proper slot number) 

2 GOSUB 32767 : PART=PITCH+1 : OFFSET=PITCH+3 : WIDTH=PITCH+4 - 
CHROMA=PITCH+/ : PULSE=PITCH+19 : VOL1=VOLQ+1 : VOL2=VOL9+2 

NOTE: Applesoft does not allow three variables to be named VOL@, VOL1, and VOL2. 

Applesoft users should pick names for VOL1 and VOL2 (if they need these 

variables) which do not begin with the same 2 letters as any other variable, and 
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complain to Microsoft. 


PARTIAL INITIALIZER 


When more than one music card is used, the units not initialized with the 
INITIALIZER (GOSUB 32767) must be initialized with the PARTIAL INITIALIZER. For 
each additional card, set SLOT to the proper expansion slot number, and call the 
PARTIAL INITIALIZER using GOSUB -2. It will initialize the music card and set 
VOL to the volume control address for that slot number. Previous values of 
VOL@ set by the INITIALIZER or PARTIAL INITIALIZER should be assigned to other 
variables if they must be retained. (The value of VOL@ for any slot is computed 
by the formula VOL@=SLOT*16-16256.) Note that GOSUB -2 does not cause the slot 
number times 16 to be written at PITCH+2 or a zero to be written at PITCH+t3. 
GOSUB -3 can be used instead if you wish to have these values poked. (On 
systems where Applesoft doesn't allow GOSUB with negative numbers, use 63998 
instead of -2 and 63997 instead of -3.) 


CHROMA 


CHROMA uses the parameters poked at PITCH, PART, PITCH+2, and OFFSET. It 
changes the contents of PITCH+5 and PITCH+6. When called using CALL CHROMA (or 
CALL PITCH+7), CHROMA programs the desired channel (indicated by PART) on the 
desired music card (indicated by the slot number times 16 at PITCH+2) with the 
desired pitch (indicated by PITCH and OFFSET). To do this, CHROMA will calculate 
a two-byte divisor which it stores at PITCH+5 and PITCH+6 in case it is needed 
for PULSE (see the PULSE routine in this section). The precise function of these 
poked parameters is as follows: 











PART (PITCH+1) 

This tndicates which of the three channels is to be programmed. It must be an 
integer from — to 2. Adding 128 will inhibit programming of the music card but 
the divisor will still be computed and stored. 


PIT CH+2 

This indicates the slot number of the music card to be programmed. The value 
poked must be the slot number (@ to 7) times 16. If only one music card is used, 
this parameter does not need to be poked since it is initialized to SLOT*16 by 
the INITIALIZER. 


PITCH 
This indicates the quarter-tone pitch to be programmed. The values for half- 
tones in the lowest octave are: 
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", A 8 C sharp 16 F 
2 A sharp 12 OD 18 F sharp 
4 = B 12 D sharp 20 G 
5 6|OCC 14 E 22 G sharp 


For quarter-tones, add 1. For higher octaves, add the numbers shown below to 
the numbers shown above. The frequency of the A in that octave is also shown 
below. (Note: "octaves" here start at A.) 


A (Hz) Add A (Hz) Add A (Hz) Add A (Hz) Add 
LID 4 119 48 449 96 1769 144 
29 24 22D 72 880 129 3520 168 


The highest pitch (G sharp plus a quarter-step) in the highest octave is 22+1+168 
(or 191), so pitch values should be from ™ to 191. Some common notes and their 
values are (for sharp, add 2; for flat, subtract 2): 


Hex Decimal Note 







# 
y 









79 112 F 
—_ ei 

6A 196 D 
w 4 66 192 C 
| { 64 10@ B 

60 96 A 449 

4 Me 5C 92 G 

ASL 58 88 E 

56 86 E 

52 82 D 

4E 78 Middle C 

4C 76 B 

48 72 A 
Be % & 44 68 G 

4g 64 F 
ww, a 3E 62 E 

3A 58 D 

34 52 B 

39 48 A 

2C 44 G 


OFFSET (PITCH+3) 

This indicates how sharp the pitch should be from standard tuning. @ is used 
for standard A=449 Hz tuning (as initialized by GOSUB 32767 or GOSUB -3), and 
numbers from 1 to 255 are used to raise the pitch slightly. All pitches selected 
using OFFSET are less than or equal to the pitch selected by a PITCH setting one 
higher. Note that the pitches selected by various values of PITCH increase 
exponentially, whereas the pitches selected by various values of OFFSET (with a 
constant PITCH setting) increase linearly. 
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PULSE 


The PULSE routine is used to create pulse waves using channel @ and/or channel 
1. The frequency (pitch) of the pulse wave will be the same as the frequency of 
channel 2. The INITIALIZER sets all channels to normal mode, so channels to be 
used with PULSE must be changed to "pulse mode" as previously described. The 
parameters poked at PART, PITCH+2, WIDTH, PITCH+5, and at PITCH+6 are used. 
PULSE is called using CALL PULSE (or CALL PITCH+1Q). The precise function of 
each parameter is as follows: 


PART (PITCH+1) 

This indicates which of the two channels is to be programmed. It must be either 
9 or 1. Adding 128 will inhibit programming of the music card but the divisor 
will still be calculated and stored (see divisor storage locations below). 


PITCH+2 
This indicates the slot number of the music card to be programmed. The value 
must be the slot number (9 to 7) times 16. 


WIDTH (PITCH+4) 

This indicates the width of the low part of each cycle. Numbers from 9 to 126 
indicate a short low portion, and numbers from 128 to 255 indicate a long low 
portion. 12/7 is used to program a square waveform. 


PITCH+5 and PITCH+6 

These must contain the divisor currently programmed for channel 2. If CHROMA 
was called most recently for channel 2, these locations will already be set to 
the divisor (by CHROMA). 








The divisor calculated by PULSE is stored at locations 81 and 82 decimal (61 and 
62 in Applesoft). It may be read using peek immediately after calling PULSE. 
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CHROMA EXAMPLE 


To program a three note chord of Middle C, E, G at maximum volume, begin by 
loading CHROMA. Now type in the following program, remembering to Change the 4 
to the correct expansion slot number. 

1Q SLOT=4 

2) GOSUB 32767 : PART=PITCH+1 : OFFSET=PITCH+3 : CHROMA=PITCH+7 

30 POKE PART,@ : POKE PITCH,78 : CALL CHROMA : POKE VOLQ,255 

49 POKE PART,1 : POKE PITCH,86 : CALL CHROMA : POKE VOL@+1,255 

of POKE PART,2 : POKE PITCH,92 : CALL CHROMA : POKE VOL9+2,255 

6 END 


Now run the program. The music card will be programmed for the C E G chord, 
and it will continue to produce the chord until programmed to do Something else. 
The chord can be cleared by typing GOTO -2. 


PULSE EXAMPLE 


The following program produces one tone with the pitch controlled by Paddle Q 
and the pulse width controlled by Paddle 1. As in the above example, begin by 
loading CHROMA. Then add the program below, remembering to correct the slot 
number. 

1Q SLOT=4 

20 GOSUB 32767 : PART=PITCH+2 : WIDTH=PITCH+4 

3 CHROMA=PITCH+7 : PULSE=PITCH+1@ : POKE VOL(+7,59 : POKE VOL9+3,2 

49 POKE PART,2 : POKE PITCH,PDL(Q)/2 : CALL CHROMA 

0M POKE PART,@ : POKE WIDTH,PDL(1) : CALL PULSE 


69 POKE VOLQ,255 : GOTO 49 


Now run the program, and twist the paddle knobs like mad. Stop the program, and 
type POKE VOL9,@ to stop the noise. 
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The MC1 is programmed by means of 3 “ports”. Each port controls three channels 
(numbered 9-2) in a particular stereo position. Each port has been assigned a 
particular memory address, and information can be sent to a port by writing a 
byte (an integer form 9 to 255) to that memory address (using 6592 Assembly 
Language or BASIC's POKE). Reading from these memory addresses does not affect 
the music card. The ports are numbered from 9 to 2. The memory address of 
each port is calculated by the formula SLOT*16-16256+P where SLOT is the 
expansion slot number used by the music card and P is the stereo position 
number (~=left, l=right, and 2=middle). 


INITIALIZATION 


Before use, the music card should be initialized. Upon power on, the music card 
will generally produce random tones at high volumes. Therefore, the volumes of 
all nine channels, plus the three noise channels, should be programmed to zero. 
Additionally a mode control byte must be sent to each stereo position. The mode 
control value is 231. Thus, a BASIC initialization program would appear as 
follows: 





FOR P= TO 2 

A=SLOT *16-16256+P 

POKE A,159 : POKE A,191 : POKE A,223 : POKE A,255 
POKE A,231 

NEXT P 





The first line of pokes zeros the volumes, and the second poke line sets the 
mode. 


VOLUME 


The volume levels of each of the three channels for each stereo position, and 
the volume levels of the white noise in each stereo position, can all be 
programmed independently. The formula 159+32*C-V, where C is the channel 
number (@ to 3) and V is the volume (@ to 15) is used to program volume. Channel 
3 is the white noise volume. For example, to set channel 2 to full volume (15), 
you would write 159+32*2-15 which is 298. This could be done using 
POKE SLOT *16-16256+P,2908. | 


The amount of attenuation (from full volume) is approximately 39-2*V dB for 
values of V from 1 to 15. V=9 is “off" (infinite attenuation). 


FREQUENCY 


The frequencies (pitches) of each of the three channels for each stereo position 
can all be programmed independently. (Note: the pitch of channel 2 affects the 
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white noise output as well.) Any frequency 63929/D Hz, where D is an integer 
from 1 to 1923, can be selected. Two bytes must be written. The first byte is 
computed by the formula 128+32*C+D MOD 16, where C is the channel number (9 to 
2) and D is the frequency divisor (1 to 1923). Using INT instead of MOD, the 
formula is 128+32*C+D-INT(D/16)*16. The second byte is computed by the formula 
D/16, or INT(D/16). Both bytes must be written at address SLOT *16-16256+P, and 
the first byte must be written first. 


6502 PROGRAMMING 


When programming in 6502 Assembly (or Machine) Language, an additional 
consideration occurs. 18 cycles must be allowed to pass between each write. 
This 1s normally a concern only when programming the frequency, since then two 
bytes must be written in succession. The 18 cycle requirement is easily met by 
arranging calculations to occur between the two frequency byte writes, or by 
inserting NOPs. 


DIVISOR CALCULATION 


Pitches and volumes must increase (and decrease) exponentially to achieve an 
apparent linear increase (for humans). Exponential volume increases are 
automatically created by the exponential amplifiers in the volume control 
circuitry. Exponential pitch increases must be created by selecting divisors 
which result in exponentially higher (and lower) pitches. 





The most common exponential pitch spacing is the equal tempered scale, which is 
Similar to the piano scale. This scale is divided into "octaves" with 12 notes 
per octave (half tones) or 24 notes per octave (quarter tones) depending on the 
application. An octave is defined to mean that the frequency of a note is twice 
that of the same note in the next lower octave. The frequency, F(N), of any 
particular note, N, in an octave is calculated by F(N)=F(@)*(2 # (N/X)) where X is 
the number of notes per octave, F(Q) is the frequency (pitch) of the lowest note 
in the octave (in Hz, or cycles per second), and N must be an integer from Q to 
X-1. (Note: although written in standard BASIC format, the formulas here are not 
intended to be computed in BASIC without careful consideration of the accuracy 
required. Floating-point calculation should be used in any case.) The frequency, 
F(N,Q), of any given note, N, in any given octave, Q, is calculated 
F(N,Q)=F(N,@)*(2 + Q) where F(N,Q) is equivalent to F(N) in the previous formula and 
Q 1s an integer. The lowest note on a piano has a frequency of 27.5 Hz (using 
Standard A=449 Hz tuning). Thus the frequency, F(N,Q), of any piano note is 
F(N,Q)=27.5*(2 ¢ (Q+N/12)) Hz, where N is the note number from @ to 11 and Q is the 
octave number from # to 7. (Note: pianos have no notes where N is greater than 
3 if Q is 7. N= indicates an A natural pitch.) Therefore the desired divisors 
for piano notes are: D(N,Q)=INT(63929/(27.5*(2 $ (Q+N/12)))+9.5). Note that the 12 
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can be replaced with a 24 (and the range of N extended to §-23) to obtain 
quarter tones. It is usually convenient to calculate divisors using a small look- 
up table containing D(N,@) and dividing by 2¢Q and rounding. This is easily 
accomplished in Assembly Language by shifting the divisor right Q times (shifting 
in Q's) and then adding in the last bit shifted out in order to round. 


Note that since divisors less than 1 or greater than 1923 cannot be used, the 
lowest notes on a piano cannot be programmed. The highest notes cannot be 
programmed since the tuning inaccuracy becomes very large at higher frequencies 
(smaller divisors). 
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The MCl6 is programmed by means of 8 "ports". Each port is assigned a 
particular memory address, and information can be sent to a port by writing a 
byte (an integer from ™ to 255) to that memory address (using 6592 Assembly 
Language or BASIC's POKE). Reading from these memory addresses does not affect 
the music card. The ports are numbered from #@ to 7. The memory address of 
each port is calculated by the formula SLOT*16-16256+P where SLOT is the 
expansion slot number used by the music card and P is the desired port number 
(both should be ™ to 7). 


The function of each port is as follows: 
PORT FUNCTION 

Volume control for channel Q 
Volume control for channel 1 
Volume control for channel 2 
Mode control A 

Divisor for channel Q 

Divisor for channel 1 

Divisor for channel 2 

Mode control B 


NOW OP WN KF BD 


Ports §-2 are used to control the volume. A byte written to one of these ports 
will cause the volume of the appropriate channel to change immediately to the 
new value (Q=off or l=soft to 255=loud). The relative output voltage for any 
volume setting (VOL) is computed by 2 (VOL/32)*(VOL MOD 32 + 33)-33 with Integer 
BASIC, or by 2. INT(VOL/32)*(VOL-INT(VOL/32)*32 + 33)-33 with Applesoft BASIC. 





Ports 3 and 7 are used for mode control. Before use, all channels must be 
initialized to either normal mode or pulse mode to insure proper operation. Port 
3 selects whether the pitch control will be provided by the Apple or by the 
output of Channel 2. Port / selects whether the divisor will control the pitch or 
the pulse width. Normally both ports 3 and 7 are set to indicate either normal 
mode or pulse mode. Port 7 should be programmed before port 3 for best 
results. 


The value written to port 3 has the following effects: 
VALUE MEANING 


D Both channels §@ and 1 to pulse mode 

l Channel § to normal mode, channel 1 to pulse mode 
2 Channel Q to pulse mode, channel 1 to normal mode 
3 Both channels @ and 1 to normal mode 


Other values should not be used. 
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Values written to port /7 have the following effects: 
VALUE MEANING 


5D Set channel 9 to pulse mode, channels 1 and 2 not affected 
54 Set channel @ to normal mode, channels 1 and 2 not affected 
114 Set channel 1 to pulse mode, channels @ and 2 not affected 
118 Set channel 1 to normal mode, channels Q@ and 2 not affected 
182 Set channel 2 to normal mode, channels Q and 1 not affected 


Other values should not be used except as noted in the TIMING MODE section. 


When a channel is set to a mode using port /, the output of its pitch generator 
will go high and stay high until both bytes of a divisor are written. The high 
part of the cycle will then begin. (Note: port 3 should be set after port 7 is 
set but before the first divisor is programmed.) | 


When a Channel is set to pulse mode with port 7/7 but normal mode with port 3, the 
Output of its pitch generator will stay high. When a channel is set to pulse 
mode with port 3 but normal mode with port /, the output of its pitch generator 
will be high when the output of channel 2's pitch generator is low, and when the 
channel 2 output goes high the mixed-mode channel will begin normal square wave 
operation starting with the high part of the cycle. (Once the channel 2 output 
returns to low, the mixed-mode channel will go high and stay high until the 
channel 2 output goes high again.) 


Any of the three channels can also be set to a special "timing mode" where the 
channel is used to simulate the Apple "paddle" timers, but with a programmable 
Setting. See the TIMING MODE section for details. 


Ports 4-6 are used to program the divisor. Once a channel has been initialized, 
it will be expecting the low byte of the divisor (D MOD 256). Once the low byte 
is written, it will be expecting the high byte of the divisor (D/256). Once the 
high byte is written, the new divisor will be used by the pitch generator; and 
the low byte of the next divisor will be expected. 


When in normal mode, the divisor determines the frequency to be produced by the 
pitch generator. The duty cycle is always approximately 5%% and cannot be 
altered. The output frequency will be 1/782999/D Hz (where D is the divisor 
programmed) plus or minus 9.915%. The value D must be an integer from 32 to 
65536. (Note: 65536 must be programmed as 9. Values less than 32 are possible 
but should not be used.) When a new divisor is programmed, it does not take 
effect until the associated pitch generator's output goes high after the high byte 
of the divisor was written. 


When in pulse mode, the divisor determines the time duration of the low portion 
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of the pulse wave. The frequency is determined by the frequency output of 
channel 2's pitch generator. Just after the low to high change of channel 2's 
pitch generator output, the output of the pulse mode channel's pitch generator 
will go low. It will stay low for D/1/78299 seconds plus or minus 9.915%. If 
the channel 2 output has again gone high during this time, the pulse mode output 
will stay low. Otherwise, the pulse mode output will go high and stay high until 
the next time the channel 2 output goes high. The value D must be an integer 
from 1 to 65536. (Note: 65536 must be programmed as 9.) When a new divisor is 
programmed, it does not take effect until the first low to high change in the 
Output of channel 2's pitch generator after the high byte of the divisor was 
written. 


DIVISOR CALCULATION 


Pitches and volumes must increase (and decrease) exponentially to achieve an 
apparent linear increase (for humans). Exponential volume increases are 
automatically created by the exponential amplifiers in the volume control 
circuitry. Exponential pitch increases must be created by selecting divisors 
which result in exponentially higher (and lower) pitches. 





The most common exponential pitch spacing is the equal tempered scale, which is 
Similar to the piano scale. This scale is divided into "octaves" with 12 notes 
per octave (half tones) or 24 notes per octave (quarter tones) depending on the 
application. An octave is defined to mean that the frequency of a note is twice 
that of the same note in the next lower octave. The frequency, F(N), of any 
particular note, N, in an octave is calculated by F(N)=F(Q)*(2 4 (N/X)) where X is 
the number of notes per octave, F(@) is the frequency (pitch) of the lowest note 
in the octave (in Hz, or cycles per second), and N must be an integer from Q to 
X-1. (Note: although written in standard BASIC format, the formulas here are not 
intended to be computed in BASIC without careful consideration of the accuracy 
required. Floating-point calculation should be used in any case.) The frequency, 
F(N,Q), of any given note, N, in any given octave, Q, is calculated 
F(N,Q)=F(N,0)*(2 +Q) where F(N,@) is equivalent to F(N) in the previous formula and 
Q is an integer. The lowest note on a piano has a frequency of 27.5 Hz (using 
Standard A=449 Hz tuning). Thus the frequency, F(N,Q), of any piano note is 
F(N,Q)=27.5*(2 # (Q+N/12)) Hz, where N is the note number from Q to 11 and Q is the 
octave number from @ to 7. (Note: pianos have no notes where N is greater than 
3 if Q is 7. N= indicates an A natural pitch.) Therefore the desired divisors 
for piano notes are: D(N,Q)=INT(1782999/(27.5*(2 4 (Q+N/12)))+9.5). Note that the 12 
can be replaced with a 24 (and the range of N extended to 9-23) to obtain 
quarter tones. It is usually convenient to calculate divisors using a small look- 
up table containing D(N,Q) and dividing by 2¢Q and rounding. This is easily 
accomplished in assembly language by shifting the divisor right Q times (shifting 
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in O's) and then adding in the last bit shifted out in order to round. 


TUNING 


It may be useful to know that musicians use "cents" to express the amount of 
deviation from correct tuning for half tones. A note too high (sharp) by 199 
cents would be the right frequency for the next higher half step. The formula 
for cents is (12PM*LOG(F/X))/LOG(2) where X is the correct frequency in Hz and F 
is the actual frequency produced in Hz. (The LOG may be in any base, as long as 
it is always the same base.) Inaccurate tuning in the music card's pitches 
results mainly from the fact that only integral values can be used for the 
divisor (D). This creates pitches out of tune by amounts varying from @ to 9.929 
cents in the lowest 12 notes of the piano scale, which increase to 9.967 to 1.294 
cents in the top 12 notes. (The 9.915% crystal accuracy adds a maximum of 9.269 
cents.) Tuning accuracy within 2 cents should be considered excellent and 
Suitable for any purpose. 
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The PERFORM program is used to play songs from your own Applesoft programs. It 
can play songs entered with ENTRY, or songs created by other means (see the 
SONG DATA description in this section). 


If you wish to play an ENTRY-created song from your own BASIC program, it will 
first be necessary to convert the song into a binary file so your program can 
load it. In order to play a song, its data must be initialized to have the 
correct SLOT setting (and UNITS setting, for the MC16) for your system. The 
easiest way to do this is to run a properly configured ENTRY program (see the 
ENTRY section), load the song and play it, then save the song back on disk. 
ENTRY's PLAY command will configure the song. (Note: you must remember to SAVE 
the configured song back on disk, or the disk copy of the song will not be 
configured.) Once you have done this, you are ready to convert the song into a 
binary file. (Note that it will be necessary to reconfigure the song if you 
change the slot location of your music card.) The following Applesoft BASIC 
program converts songs into binary files. Type it in and save it. 


1f POKE 76,PEEK(115) : POKE 77,PEEK(116) : POKE 217.9 

20 HIMEM:3999 : INPUT "SONG NAME?":A$ 

3) POKE PEEK(54)+PEEK(55)*256+3965.9 

49 PRINT CHR$(4)"LOADM:"A$ : A=PEEK(292)+PEEK(203)*256 

5@ L=PEEK(76)+PEEK(77)*256-A : PRINT CHR$(4)"BSAVE"A$".A"A"L"L 
6) PRINT “LENGTH: "L : PRINT CHR$(4)"FP" 





To use the program, begin by typing FP. Then RUN the program. It will ask for a 
song name. Type in the name of the song to be converted (without the M:) and 
press return. The song will be converted and saved on your disk as a binary 
file with the same name as the song but without the M:. The conversion program 
also prints the length of the song in bytes. Although this length can be 
determined simply by BLOADing the song and looking at the DOS file length 
locations (see your DOS manual), you may wish to write the length down since you 
will probably need to know it. To convert another song, follow the instructions 
above again. You can omit the initial FP but you must load the program again to 
run it (or use RUN name) since the program self-destructs each time it is used. 


AN EXAMPLE 


Let's say you want to try this procedure with the sample song DIXIE BOOGIE. 
First, save the conversion program given above. Let's assume you named the 
conversion program CONVERT. Now, RUN ENTRY. (This assumes you have already 
configured ENTRY for your system configuration as described in the ENTRY 
section.) LOAD:DIXIE BOOGIE, PLAY, and SAVE:DIXIE BOOGIE. Now type FP to exit 
cNIRY. You are now ready to convert the song. Type FP and RUN CONVERT. It will 
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to the end of either version in order to create a subroutine which can be 
GOSUBed in order to configure and play the song at address ADRS. 


READING THE “INITIAL SPEED” 


Assuming the song was just loaded using PRINT CHR$(4)"BLOAD song name,A"ADRS the 
initial speed of an ENTRY-created song can be read into the variable S with the 
following statement: S=PEEK(PEEK(43616)+PEEK(43617)*256+ADRS-161). (43616 is the 
DOS 3.2/3.3 BLOAD program length address for 48K and larger systems.) This can 
be converted to initial rate by subtracting 11 times the number of parts. 
PEEK(ADRS) gives the number of parts. 


SAMPLE PERFORM SESSION 


In the following sample session, we write a small program which plays a song, 
much like the PLAY program does. The program is for the MCl, changes needed 
for the MC16 are shown in parentheses. 





|FP 

J19 POKE 76,PEEK(115) : POKE 77,PEEK(116) : POKE 217, 

12) HIMEM:3999 : INPUT "SONG NAME ?":A$ 

139 POKE PEEK(54)+PEEK(55)*256+3965,0 

149 PRINT CHR$(4)"LOADM:"A$ : A=PEEK(292)+PEEK(293)*256 

]59 L=PEEK(76)+PEEK(77)*256-A : PRINT CHR$(4)"BSAVE"A$".A"A'.L"L 
169 PRINT "LENGTH: "L : PRINT CHR$(4)"FP" 

JSAVE CONVERT 

JRUN 

SONG NAME ?DIXIE BOOGIE 





LENGTH: 3298 


|FP 

J5 ADRS=8192 : HIMEM:ADRS 

J19 SLOT=4 (]19 SLOT=4 : UNITS=1) 

J29 PRINT CHR$(4)"BLOAD PERFORM" 

J3Q PN=SLOT *16-16256 (]39 FOR S=SLOT TO SLOT+UNIT S-1) 

J4@ FOR P=PN TO PN+2 
(49 PN=16*S-16256 : POKE PN,@ : POKE PN+1,@ : POKE PN+2,—) 

J59 POKE P,159 : POKE P,191 : POKE P,223 : POKE P,255 : POKE P,231 
(]59 POKE PN+3,3 : POKE PN+7,54 : POKE PN+7,118 : POKE PN+/7,182) 

]69 NEXT P (6M NEXT S) 

J72 INPUT "SONG NAME ?":A$ : PRINT CHR$(4)"BLOAD"A$",A"ADRS 

189 FOR B=1 TO PEEK(ADRS) 

199 PNT R=PEEK(B+B+ADRS-1)+PEEK(B+B+ADRS )*256+ADRS 
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(]99 PNTR=PEEK(B+B+ADRS-1)+PEEK(B+B+ADRS)*256+ADRS : CHAN=B-1) 
J1Q%9 CHAN=PEEK(PNTR+2)-INT(PEEK(PNTR+2)/4)*4 

(J190 IF UNITS>1 THEN CHAN=PEEK(PNTR+2)/(1+15%*(3-UNITS)) ) 
]11P NAHC=INT((PEEK(PNTR+2)-INT (PEEK(PNTR+2)/16)*16)/4) 

(line 119 not needed for MC16) 
J129 IF NAHC THEN NAHC=3-NAHC 

(J129 CHAN=CHAN-INT(CHAN/16)*16 : POKE PNTR+1,INT(CHAN/4)*12+CHAN+SLOT *16) 
J13Q POKE PNTR+1,SLOT *16+CHAN*4+NAHC 

(line 132 not needed for MC16) 
4J149 NEXT B 
J159 POKE 36864,ADRS-INT(ADRS/256)*256 : POKE 36865,ADRS/256 
J169 POKE 6,PEEK(PEEK(43616)+PEEK(43617)*256+ADRS-161)-11*PEEK(ADRS) 
J179 CALL 36866 : GOTO 79 
JSAVE YALP 
JRUN 
SONG NAME ?DIXIE BOOGIE 


(song plays) 
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FLASH 


The FLASH program is the same as the PERFORM program except it generates the 
lo-res color graphics display (like ENTRY and PLAY). It is used in exactly the 
same fashion as PERFORM, except that the color display must be set up before 
FLASH is called. The following routine sets up the display: 


GR 

FOR A=1 TO PEEK(ADRS) 
COLOR=2 : HLIN 9,39 AT A*4-2 
COLOR=13 : PLOT 15,A*4-2 
NEXT 


The "YALP" program (from the PERFORM sample session) can be modifed to use 
FLASH as follows: 


FP 

JLOAD YALP 

]2@ PRINT CHR$(4)"BLOAD FLASH" 
1179 GR 

]18Q FOR A=1 TO PEEK(ADRS) 

119 COLOR=2 : HLIN 9,39 AT A*4-2 
1299 COLOR=13 : PLOT 15,A*4-2 
1210 NEXT 

122 CALL 36866 : TEXT : GOTO 79 
JSAVE NEW YALP 

JRUN 

SONG NAME 2DIXIE BOOGIE 


(song plays with display) 
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BLOCK DIAGRAM © 
Entry Point 


initialize program variables wait until 
DELAY AMOUNT = 


DELAY AMOUNT © RATE 
set for Part -l 


select the parameters for the next Part 


CURRENT LOUDNESS = 
CURRENT LOUDNESS < DESIRED LOUDNESS DESIRED LOUDNESS 


CURRENT LOUDNESS > 
DESIRED LOUDNESS 


CURRENT LOUDNESS <— DESIRED LOUDNESS <— 
CURRENT LOUDNESS - CURRENT SUSTAIN LEVEL 





CURRENT LOUDNESS <— 
CURRENT LOUDNESS + 


ATTACK RATE 


CURRENT DECAY RATE 





overshot undershot 
DESIRED DESIRED ( } 
LOUDNESS — LOUDNESS 


CURRENT LOUDNESS <— 
DESIRED LOUDNESS 


send CURRENT LOUDNESS/256 
to unit 
last Part ® not the last Part 


2 
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set for Part -l 


select the parameters for the next Part 


TIME REMAINING = GAP SIZE 


CURRENT DECAY RATE < 
RELEASE RATE 


DESIRED LOUDNESS < 9 (3) 


CURRENT SUSTAIN LEVEL<= 9 





TIME REMAINING <— TIME REMAINING - 1 


TIME REMAINING = -1 







Command = 
SOP 


Part not the last Part 
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4 





Command = PITCH 


a compute divisor 
REST and send to unit 


DESIRED LOUDNESS < 
VOLUME LEVEL 
CURRENT SUSTAIN LEVEL < 


DESIRED LOUDNESS < @ 


CURRENT SUSTAIN LEVEL < 9 


TIME REMAINING <— @ CURRENT DECAY RATE < 


RELEASE RATE 


SUSTAIN LEVEL 
CURRENT DECAY RATE < 
DECAY RATE 





Command = 193 through 


Command = END 200, and 205.001 
set TIME REMAINING 
Command = CALL 


Command = 
205.002 Command = Command = 
la RETURN 205.000 


process RETURN process FUZZ process CALL 
parameter 





advance pointer to next Command 





Exit 
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TECHNICAL 


PERFORM operates on one to nine sequences of commands stored in memory. Each 
Sequence of commands indicates the sounds for one channel. All the sequences 
will appear to be executed at the same time by PERFORM. There are three types 
of commands which may be used. One type is used to control the execution of the 
commands. Another type is used to set parameters for future use. The remaining 
type of command is used to wait or to produce a new pitch and wait. During the 
time "waited", PERFORM will automatically program volume settings which create 
the selected envelopes. Envelope production is explained in the ENTRY section 
and in the block diagram. 


All commands for PERFORM are three bytes long. (Each byte is an integer from Q 
to 255.) The first byte always indicates the particular command desired, and the 
second and third bytes indicate a parameter for use by that command. When the 
parameter is a two-byte integer (@ to 65535), the low byte (value MOD 256) is 
given as the second byte of the command and the high byte (value/256) is given 
as the third byte. The various commands available are described below. 


TYPE A COMMANDS 


The first type of command is used to control execution. They are CHANNEL 
NUMBER, CALL, RETURN, STOP, and END. 





CHANNEL NUMBER 

The CHANNEL NUMBER command is used to indicate the slot and channel number to 
be programmed. Ihe second byte should be 16 times the expansion slot number 
plus the stereo position code (f=left, l=right, 2=middle) plus 4 times the channel 
number (f-2) within the stereo position (on the MC16, the stereo position code is 
always @ since position is indicated by slot number). Although PERFORM does not 
use the third byte, it should be used to indicate stereo positioning. Its most 
Significant four bits indicate stereo positioning for performance with two MC16 
units (meaningless in songs that have more than six parts), and the least 
Significant four bits indicate stereo for the MCl or for three MC16's. In each 
half byte, the two most significant bits indicate a stereo position code (f=left, 
l=middle, 2=right). The two least significant bits indicate the channel number 
within the stereo position (f to 2). The first command in each part must be a 
CHANNEL NUMBER command. ENTRY compatible songs may have only one CHANNEL 
NUMBER command per part. 


CALL 
The CALL command is used to perform a subroutine call. The second and third 
bytes indicate the relative address of the subroutine. During playback, the 
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commands in the subroutine will be executed, and then PERFORM will continue jin 
the usual fashion with the commands following the CALL. 


RETURN 

The RETURN command marks the end of a subroutine, and causes PERFORM to 
continue at the commands following the CALL. The second and third bytes must be 
the same as the second and third bytes of the CALL command. ENTRY compatible 
songs may have only one RETURN command per subroutine. 


STOP 

The STOP command indicates the end of one part's (or channel's) commands. The 
envelope generator will continue to operate after a STOP command if no other 
channel has encountered an END command. The second and third bytes are not 
used and should be set to Q. All parts except the last one should end with a 
STOP command. ENTRY compatible songs may have only one STOP command per Darts 


END 

The END command is used to terminate PERFORM and return to the calling program. 
The last part should end with an END command rather than a STOP command. 
Further, the END command should be positioned as the last command in all the 
data (in ENTRY compatible songs, this is followed by the “initial speed" byte and 
the 169 title bytes). Envelope production does not continue once any part 
executes an END command. The second and third bytes are not used, and should 
be set to @. 


TYPE B COMMANDS 


The second type of command is used to set parameters. They are TRANSPOSE, GAP 
SIZE, ATTACK RATE, DECAY RATE, VOLUME LEVEL, SUSTAIN LEVEL, RELEASE RATE, and 
FUZZ. 


TRANSPOSE 

The TRANSPOSE command is used to add or subtract a constant from all following 
pitch values (until a new TRANSPOSE value is programmed). The second byte 
indicates the amount to add or subtract. 9 to 127 will add a value of @ to 127. 
128 to 255 will subtract a value of 128 to 1. Since the values are in quarter- 
steps, adding a value of 24 will raise the pitch by one octave. The third byte 
1s the pitch mask byte. All following pitch values are ANDed with the pitch mask 
byte (before the second byte transpose value is added or Subtracted). This byte 
1s normally set to 255. ENTRY compatible songs use a value of 254 to allow 
sharp/flat display selection with the least significant pitch bit. On the MC1, if 
the resultant pitch number is less than 3, it will be raised by multiples of 24 
until it is 3% or greater. 
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FUZZ 

The FUZZ command is used to select "white noise" (fuzz) mode or normal mode. 
Since the "pitch" of the white noise is always controlled by channel 2 (of a 
given stereo position), FUZZ should be used only on parts operating on channel 2. 
This command is identified by the first two bytes, unlike all other commands 
which are identified by the first byte alone. The third byte must be 9 for 
“normal” or 96 for "fuzz". FUZZ is not available on the MC16. 


GAP SIZE 

The GAP SIZE command is used to control the release stage of envelope 
production. When the number of time periods remaining to wait (during a "“wait") 
equals the GAP SIZE value, the envelope parameters will automatically be changed. 
The RELEASE RATE value will be copied into the CURRENT DECAY RATE, and a 9 will 
be written into the DESIRED LOUDNESS and the CURRENT SUSTAIN LEVEL. This causes 
the CURRENT LOUDNESS (and therefore the volume) of the channel to drop to @ at 
the RELEASE RATE. The second and third bytes indicate the new GAP SIZE. When a 
release stage is not desired, the GAP SIZE should be set to 65535 (255,255). 


ATTACK RATE, DECAY RATE, VOLUME LEVEL, SUSTAIN LEVEL, RELEASE RATE 
These commands are used to set envelope parameters. The second and third bytes 
indicate the new value. 


TYPE C COMMANDS 


The third type of command is used to wait or to produce a new pitch and wait. 
The second and third bytes indicate the number of time periods to wait before 
continuing with the next command. During this wait, the envelope generator 
program in PERFORM will update the envelope parameters and reprogram the volume 
once each time period. These commands are PITCH and REST. 


PITCH 

There are 192 PITCH commands with command numbers from @ to 191. The range 
of the MCl is limited to values from 39 to 174 (see TRANSPOSE for additional 
information). The command number indicates which pitch is to be produced, 
Subject to modification by the two TRANSPOSE parameters. The resultant number 
Specifies the pitch to be programmed into the synthesizer. Pitch specification is 
in quarter-steps, with 9% being A natural at 27.5 Hz. There are 24 quarter-steps 
per octave. Thus, 24 is A natural at 55 Hz. (Note: the MCl cannot play pitches 
with values below 3; such pitches will be transposed up by one or more 
octaves.) Note that in ENTRY compatible songs, the least significant bit of the 
PITCH command number indicates whether sharp or flat should be displayed, and 
is masked off during playback (see TRANPOSE). The PITCH command also changes 
certain envelope parameters. The DECAY RATE 1S copied into the CURRENT DECAY 
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RATE, the VOLUME LEVEL is copied into the DESIRED LOUDNESS, and the SUSTAIN 
LEVEL 1s copied into the CURRENT SUSTAIN LEVEL (see the block diagram at the end 
of this section). 


REST 

The REST command causes the RELEASE RATE to be copied into the CURRENT DECAY 
RATE, and a Q to be written into the DESIRED LOUDNESS and the CURRENT SUSTAIN 
LEVEL. This causes the release portion of the envelope to begin. (Note: this is 
the same process as caused by the time remaining equaling the GAP SIZE, see the 
GAP SIZE command.) 


SONG DATA 


RELATIVE ADDRESSES 

All relative addresses used in PERFORM (for example, the second and third bytes 
of a CALL command) must be two-byte integers stored low byte first. The value 
stored must be the actual memory address minus the starting address of the song 
data. 





START OF DATA 

The first byte (stored at the starting address) must be the number of "parts" of 
data. [This must be an integer from 1 to 9. The following 2 to 18 bytes must be 
the relative address of the first command of each part. Following these bytes 
the subroutines (if any) are stored, and then the first part's commands, the 
second's, and so forth. See the diagram below. 


Two Part Song Data 


PART @ 1 2 PART 1 1 2 
altel ee Liat 
COMMANDS , 2 3 COMMANDS 2 5 


Relative Subroutines Rest Stop Rest End 
addresses (final decay) (final decay) 
Number of parts Memory addresses increase ——> 
PART DATA 


In each part, the three-byte commands are stored one after another. Each part 
must begin with a CHANNEL NUMBER command, and end with a STOP command (except 
the last part must end with an END command). See the diagram above. Although a 
part may contain more than one CHANNEL command, to do so would be incompatible 
with ENTRY and with the “song configuration" routine given earlier in this 
section. 
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SUBROUTINE DATA 

The relative calling address to a subroutine must point to several bytes of 
reserved storage which precede the first command of the subroutine. There must 
be two times as many reserved bytes as the number of parts. These reserved 
bytes must be preceded by at least 1 additional byte(s), and the number of 
additional bytes plus the number of reserved bytes must be evenly divisible by 
3. See the diagram below. 





Subroutine (in two part song data) 


Relative 


Calling 
Address y 


222.2. 2,22 2 
(Data) 5 | 5 5 | 5 | 5 5 | Subroutine Commands | 4) L H (Data) 

4'4°4,4,(4'°4 2 

Additional Reserved Return 

bytes to bytes 

make a 

multiple 

of three 


Note that the calling address must point to the first of the reserved bytes, not 
to the additional bytes nor to the first command in the subroutine. The 
additional bytes must be stored as 254's, and the reserved bytes should be set to 
294 also. When a CALL command is executed during playback, the address of the 
first command after the CALL (that is, the return address) is stored in two of 
the reserved bytes. (PERFORM assigns a different pair of bytes for each part. 
This allows several parts to call the subroutine at once.) The RETURN command 
at the end of the subroutine causes the address of the next-command-to-be- 
interpreted to be read from the correct pair of reserved bytes, thus Causing a 
“return'. Note that although a subroutine may contain more than one RETURN 
command (or a RETURN command to a different Subroutine), to do so would be 
incompatible with ENTRY. 


RATE COMMAND 


The RATE command is a rather unusual command. It is used to dynamically 
control playback speed for all parts. Like FUZZ, it is identified by the first 
two bytes. The third byte of the command indicates the new playback rate. 
"Rates" are related to "speeds" by the formula RATE=SPEED-11*(number of parts). 
Duriag playback, the number of time periods per second is approximately 
92,//7/3/SPEED or 92,773/(RATE+11*(number of parts)). Previously, the TEMPO 
commmand (available only on the MC16) was used for playback tempo control. 
TEMPO commands can generally be replaced with RATE commands using the formula 
RATE=(TEMPO/19.17)-1-11*(number of parts). 
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TEMPORARIES 


PERFORM uses locations 6-C, D@-Dl, and DD-EF for storage of temporary values 


during execution. 


FLASH uses these locations, plus F9-FD. 


COMMAND NUMBERS 


HEX 
-BF 
Cp 

Cl 

C2 

C3 

C4 

C5 

C6 

C7 

C8 

C9 

CA 

CB 

CC 

CD pp 
CD 1 
CD K* 
CE-FD 
FE 

FF 


DEC IMAL 
0-191 
192 

193 

194 

Loo 

196 

Lar 

198 

199 

200 

201 

2D2 

203 

204 

205 PPP 
295 Ppl 
205 KKK 
206-253 
254 

2909 


COMMAND 

PITCH 

Re OL 

GAP SIZE 
TRANSPOSE 
ATTACK RATE 
DECAY RATE 
VOLUME LEVEL 
SUSTAIN LEVEL 
RELEASE RATE 
CHANNEL NUMBER 
CALL 

RETURN 

STOP 

TEMPO 

FUZZ 

RATE 


(where ** or *** are > 1) no operation 


no operation 
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precedes subroutines, treated as END if found 


END 
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SCHEMATIC TERMINALS 


Connection to pin on Apple Il Peripheral |/O Bus 


—<_] Connection to pin on Access Socket A2 


{isd Connection to Audio Out molex pin 


—O Connection to power bus 
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AUDIO OUTPUTS 
Impedance: 79% ohms typical. Output: 9.91 volts peak. 


SCHEMATIC TERMINALS 


} oe Connection to pin on Apple Il Peripheral 1/O Bus 


Internal connections 


——{ id Connection to Audio Out molex pin 


——— | Connection to pin on Access Socket A4 


Boldface characters on schematic (eg. C2) refer to component locations. 


See silkscreen artwork for locations. 
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